جسم الطلب
array
مطلوب
قائمة بالرسائل التي تشكل المحادثة.يحتوي كل كائن رسالة على:
role(string):system,user, أوassistantcontent(string | array): محتوى الرسالة
content مصفوفة، يدعم TokenLab كتلًا مُهيكلة متعددة الوسائط للنماذج المتوافقة:- text:
{ "type": "text", "text": "..." } - image:
{ "type": "image_url", "image_url": { "url": "https://..." } } - video:
{ "type": "video_url", "video_url": { "url": "https://..." } } - audio:
{ "type": "audio_url", "audio_url": { "url": "https://..." } }
https عامة. سيقوم TokenLab بترجمة هذه الكتل الوسائطية إلى شكل الطلب الخاص بمزود الخدمة المطلوب للنموذج الفيزيائي الموجه.number
افتراضي:"1"
درجة حرارة العينة بين 0 و2. القيم الأعلى تجعل المخرجات أكثر عشوائية.
integer
الحد الأقصى لعدد التوكنات التي سيتم توليدها.
boolean
افتراضي:"false"
If true، سيتم إرسال دلتا الرسائل الجزئية كأحداث SSE.
object
خيارات البث. اضبط
include_usage: true لتلقي استخدام التوكنات في أجزاء البث.number
افتراضي:"1"
معامل Nucleus sampling. نوصي بتغيير هذا أو temperature، وليس كليهما.
number
افتراضي:"0"
رقم بين -2.0 و2.0. القيم الإيجابية تعاقب التوكنات المكررة.
number
افتراضي:"0"
رقم بين -2.0 و2.0. القيم الإيجابية تعاقب التوكنات الموجودة بالفعل في النص.
string | array
حتى 4 تسلسلات تتوقف عندها الـ API عن توليد التوكنات.
array
قائمة بالأدوات التي قد يستدعيها النموذج (استدعاء دوال).
string | object
يتحكم في كيفية استخدام النموذج للأدوات. الخيارات:
auto, none, required, أو كائن أداة محدد.boolean
افتراضي:"true"
ما إذا كان سيتم تمكين استدعاء الدوال المتوازي. اضبط على false لاستدعاء الدوال بشكل متسلسل.
integer
الحد الأقصى للتوكنات للاستكمال. بديل لـ
max_tokens، مفيد لعائلات النماذج الأحدث الممكّنة للتفكير.string
مستوى جهد الاستدلال للنماذج الممكّنة للتفكير. الخيارات:
low, medium, high.integer
بذرة عشوائية للعينة الحتمية.
integer
افتراضي:"1"
عدد الاستكمالات المراد توليدها (1-128).
boolean
ما إذا كان سيتم إرجاع لوغاريتمات الاحتمالات.
integer
عدد أعلى لوغاريتمات الاحتمالات المراد إرجاعها (0-20). يتطلب
logprobs: true.integer
معامل أخذ العينات Top-K (لنماذج Anthropic/Gemini).
object
مواصفات تنسيق الاستجابة. استخدم
{"type": "json_object"} لوضع JSON. اعتبر {"type": "json_schema", "json_schema": {...}} كطريق بذل أقصى جهد يعتمد على النموذج المختار والسلوك الموجَّه.object
تعديل احتمال ظهور توكنات محددة. اربط معرفات التوكن (كسلاسل) بقيم تحيّز من -100 إلى 100.
string
معرف فريد يمثل المستخدم النهائي لديك لأغراض مراقبة الإساءة.
الاستجابة
string
معرف فريد للاستكمال.
string
دائمًا
chat.completion.integer
طابع زمني بنظام Unix لوقت إنشاء الاستكمال.
string
النموذج المستخدم للاستكمال.
array
قائمة بخيارات الاستكمال.يحتوي كل خيار على:
index(integer): مؤشر الخيارmessage(object): الرسالة المولدةfinish_reason(string): سبب توقف النموذج (stop,length,tool_calls)
object
إحصاءات استخدام التوكنات.
prompt_tokens(integer): التوكنات في المطالبةcompletion_tokens(integer): التوكنات في الاستكمالtotal_tokens(integer): إجمالي التوكنات المستخدمة