نظرة عامة
توفّر هذه النقطة الطرفية توافقًا أصليًا مع Anthropic Messages API. استخدم هذا مع نماذج Claude وميزات مثل التفكير الممتد. يحافظ هذا المسار على عقد Anthropic الأصلي. يجب أن تكونmessages مصفوفة رسائل بأدوار user / assistant فقط، ويجب وضع system في الحقل العلوي system، كما أن max_tokens مطلوب. إذا كانت حمولة الطلب تستخدم أدوار OpenAI مثل system أو developer أو tool داخل messages، فأرسلها إلى /v1/chat/completions بدلًا من ذلك.
عنوان URL الأساسي لـ Anthropic SDK:
https://api.tokenlab.sh (بدون اللاحقة /v1)ترويسات الطلب
string
مطلوب
مفتاح TokenLab API الخاص بك. بديل عن Bearer token.
string
مطلوب
إصدار Anthropic API. استخدم
2023-06-01.جسم الطلب
string
مطلوب
معرّف نموذج Claude (على سبيل المثال،
claude-sonnet-4-6 أو claude-opus-4-6).array
مطلوب
مصفوفة من كائنات الرسائل تحتوي على
role و content.integer
مطلوب
الحد الأقصى لعدد الـ tokens المطلوب إنشاؤها.
string
System prompt (منفصل عن مصفوفة
messages).number
افتراضي:"1"
درجة حرارة أخذ العينات (0-1).
boolean
افتراضي:"false"
تمكين الاستجابات المتدفقة.
object
إعدادات التفكير الممتد (Claude Opus 4.5).
type(string):"enabled"للتمكينbudget_tokens(integer): ميزانية الـ tokens الخاصة بالتفكير
array
الأدوات المتاحة للنموذج.
object
كيفية استخدام النموذج للأدوات. الخيارات:
auto، any، tool (أداة محددة).number
معلمة Nucleus sampling. استخدم إما temperature أو top_p، وليس كليهما.
integer
أخذ العينات فقط من أعلى K خيارات لكل token.
array
تسلسلات إيقاف مخصصة ستؤدي إلى توقف النموذج عن التوليد.
object
بيانات وصفية لإرفاقها بالطلب لأغراض التتبع.
الاستجابة
string
معرّف فريد للرسالة.
string
دائمًا
message.string
دائمًا
assistant.array
مصفوفة من كتل المحتوى (text، thinking، tool_use).
string
النموذج المستخدم.
string
سبب توقف التوليد (
end_turn، max_tokens، tool_use).object
استخدام الـ tokens مع
input_tokens و output_tokens.مثال على إدخال الرؤية
بالنسبة إلى نماذج Claude التي تدعم الرؤية، ضع الصور داخلmessages[].content ككتل صور مُنظَّمة.
مثال على التفكير الممتد
دفعات رسائل Anthropic
يوفّر TokenLab الآن تدفق Anthropic Message Batches الأصلي إلى جانب/v1/messages.
المسارات المتاحة:
POST /v1/messages/batchesGET /v1/messages/batchesGET /v1/messages/batches/:message_batch_idGET /v1/messages/batches/:message_batch_id/resultsPOST /v1/messages/batches/:message_batch_id/cancelDELETE /v1/messages/batches/:message_batch_id
- استخدم نفس مفتاح TokenLab API مع ترويسات Anthropic الأصلية.
- إذا كانت عناصر الـ batch تشير إلى
file_id، فأضف أيضًاanthropic-beta: files-api-2025-04-14. - تحافظ مهام الـ batch على شكل الطلب/الاستجابة الأصلي لـ Anthropic، بينما يتتبع TokenLab داخليًا دورة التسوية الخاصة بها.