مستندات API

مدل‌ها و قیمت راهنماهای اتصالساخت کلید API

گفتگو و متن

شمارش توکن (قالب Anthropic)

تعداد توکن ورودی یک درخواست Messages را بدون اجرای مدل برآورد می‌کند. رایگان است و از اعتبار یا سقف نرخ کم نمی‌کند.

POST/v1/messages/count_tokens

بدنه همان بدنهٔ پیام‌ها است، بدون max_tokens . پاسخ فقط input_tokens دارد. عدد، برآورد خود 1ai است، همان که برای نگه‌داشتن اعتبار پیش از اجرا به کار می‌رود، و ممکن است با شمارش واقعی مدل کمی فرق کند. در پاسخ‌های واقعی usage مقدار دقیق را می‌بینید. این مسیر هزینه‌ای ندارد، در محدودیت نرخ حساب نمی‌شود و برای ثبت مصرف ردیف نمی‌سازد، چون کلاینت‌ها پیش از هر نوبت آن را صدا می‌زنند. کلید API لازم است.

نمونه‌ها

curl https://1ai.ir/v1/messages/count_tokens \
  -H "x-api-key: $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "anthropic/claude-sonnet-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Hello, how are you?"
    }
  ]
}'

200پاسخ

{
  "input_tokens": 8
}

هدرها

x-api-keystringالزامی
$کلید API شما. Authorization: Bearer هم پذیرفته می‌شود.$

بدنه‌ی درخواست

modelstringالزامی
$نام کامل مدل، مثل anthropic/claude-sonnet-5.5 .$
messagesarrayالزامی
$پیام‌ها، با همان قالب پیام‌ها .$
ویژگی‌های داخلی
- rolestringالزامی
  $نقش فرستنده.$
  مقادیر مجاز:userassistantsystem
- contentstring | arrayالزامی
  $متن یا آرایه‌ای از بلوک‌ها.$
systemstring | array
$دستور سیستمی.$
toolsarray
$ابزارها؛ شرح آن‌ها هم در عدد حساب می‌شود.$

خطاها

invalid_request_error400
بدنه نادرست است؛ مثلاً messages یا model نیامده.
authentication_error401
کلید نادرست، غیرفعال یا منقضی است.

صفحه‌های مرتبط