مستندات

Rerank و Moderations

سه مسیر کوچک با یک شکل: rerank، moderations و completions قدیمی.

سه مسیر کوچک که شکل یکسانی دارند: یک درخواست، یک پاسخ، بدون stream. همان کلید، همان کیف پول، همان صفحهٔ مصرف.

Rerank

POSThttps://iranrouter.com/v1/rerank

bash

curl https://iranrouter.com/v1/rerank \
  -H "Authorization: Bearer ir-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cohere/rerank-v3.5",
    "query": "بهترین رستوران تهران",
    "documents": ["رستوران الف …", "کافه ب …"],
    "top_n": 2
  }'

چیزی تولید نمی‌شود، پس هزینه فقط بر اساس ورودی است — پرسش به‌علاوهٔ همهٔ اسناد.

Moderations

POSThttps://iranrouter.com/v1/moderations

bash

curl https://iranrouter.com/v1/moderations \
  -H "Authorization: Bearer ir-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/omni-moderation-latest", "input": "متن مورد بررسی"}'

بیشتر ارائه‌دهنده‌ها بابت این مسیر چیزی نمی‌گیرند و اصلاً usage گزارش نمی‌کنند؛ در آن حالت سطر مصرف صفر ثبت می‌شود که ثبتِ صادقانهٔ همان واقعیت است.

Completions (قدیمی)

POSThttps://iranrouter.com/v1/completions

اگر انتخاب با شماست، chat/completions را ترجیح دهید. این مسیر برای ابزارهای قدیمی‌ای است که هنوز فقط همین را می‌شناسند.