مستندات

Messages (آنتروپیک)

POST /v1/messages — برای ابزارهایی که فرمت آنتروپیک حرف می‌زنند.

POSThttps://iranrouter.com/v1/messages

بعضی ابزارها به‌جای فرمت OpenAI مستقیم با فرمت Messages آنتروپیک کار می‌کنند. برای آن‌ها لازم نیست دنبال آداپتور بگردید — همین نشانی این مسیر را هم پاسخ می‌دهد، با همان کلید `ir-`.

bash

curl https://iranrouter.com/v1/messages \
  -H "Authorization: Bearer ir-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "سلام"}]
  }'

چه چیزی ترجمه می‌شود

پیام system به‌صورت رشته یا بلوک، و بلوک‌های text / image / tool_use / tool_result
ابزارها در هر دو جهت: tools → tool_use در پاسخ، و finish_reason → stop_reason
رویدادهای stream به شکل آنتروپیک.

/v1/messages/count_tokens کار می‌کند و رایگان است — تماسی به بالادست نمی‌رود. عدد یک تخمین است، با همان حسابی که رزرو کیف پول انجام می‌شود؛ برای مدیریت context کافی است، برای شمارش دقیق نه.

اگر انتخاب با شماست، chat/completions را ترجیح دهید — مسیر اصلی و کامل‌تر است.