ایران ناتیفیکیشن

بردار معنایی (Embedding)

تبدیل متن به بردار، سازگار با OpenAI.

POSThttps://api.irnoti.com/v1/ai/embeddings
scope: ai.embed

input رشته یا آرایه‌ای تا ۹۶ رشته (هر کدام تا ۳۲٬۰۰۰ نویسه). بردارها همیشه عددیِ float هستند. هزینه بر اساس توکن ورودی است. در پاسخ، هدرهای X-Credits-Charged، X-Credits-Balance و X-Wallet-Rial-Charged مصرف را نشان می‌دهد و بلوک irnoti همان مقادیر را در بدنه دارد. سقف ۱۲۰ درخواست در دقیقه.

پارامترها

ناممحلنوعتوضیح
input *بدنهstring | string[]متن(ها).
modelبدنهstringکد مدل.
encoding_formatبدنهstringفقط float.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400validation_errorورودی نامعتبر است (جزئیات در پاسخ).
429rate_limitedتعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/ai/embeddings' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": [
    "سلام دنیا"
  ]
}'
پاسخ نمونه200 OK
{
  "data": [
    {
      "index": 0,
      "object": "embedding",
      "embedding": [
        0.012,
        -0.034
      ]
    }
  ],
  "model": "emb-1",
  "usage": {
    "total_tokens": 4,
    "prompt_tokens": 4
  },
  "irnoti": {
    "credits_balance": "999",
    "credits_charged": "1",
    "wallet_rial_charged": "0"
  },
  "object": "list"
}
بردار معنایی (Embedding) — مستندات API | ایران ناتیفیکیشن