مستندات

Embeddings

بردار برای هر ورودی، سازگار با OpenAI. بدون stream، و هزینه فقط بر اساس ورودی.

POSThttps://iranrouter.com/v1/embeddings

بردار برای هر ورودی، سازگار با فرمت OpenAI. بدون stream — یک درخواست، یک پاسخ. همان کلید `ir-` و همان کیف پول.

bash

curl https://iranrouter.com/v1/embeddings \
  -H "Authorization: Bearer ir-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": ["سلام دنیا", "hello world"]
  }'

چند نکته

ورودی می‌تواند یک رشته، آرایه‌ای از رشته‌ها، یا آرایه‌ای از توکن‌ها باشد. هزینه فقط بر اساس ورودی است — خروجی توکنی ندارد.
پاسخ همان چیزی است که ارائه‌دهنده می‌دهد، به‌علاوهٔ usage.cost_rial و هدر x-request-id که همان شناسه‌ای است که در «مصرف» می‌بینید.
همهٔ مدل‌های کاتالوگ embedding نیستند. اگر مدلی این مسیر را پشتیبانی نکند، پاسخ ۵۰۳ با کد no_capacity است.
با Idempotency-Key یک تلاش دوباره هرگز دوبار شارژ نمی‌شود. اگر پاسخ اصلی برای بازپخش خیلی بزرگ بوده باشد (یک batch بزرگ embeddings معمولاً هست)، تلاش دوم به‌جای اجرای دوباره، خطای ۴۰۹ با کد idempotency_completed_unreplayable می‌گیرد: یعنی «قبلی کامل شد»، و انتخاب با شماست که با کلید تازه دوباره اجرا کنید یا نه.