الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

تُعد Responses API واجهة محادثة جديدة ذات حالة من OpenAI. يدعم TokenLab هذا التنسيق كمسار اختياري متقدم للنماذج المتوافقة؛ استخدم POST /v1/chat/completions كالمسار الافتراضي المتوافق مع OpenAI ما لم تكن تحتاج صراحةً إلى سلوك خاص بـ Responses.

​
جسم الطلب

​
model
string
مطلوب
معرّف النموذج المطلوب استخدامه. راجع Models للاطلاع على الخيارات المتاحة.
​
input
array
مطلوب
قائمة بعناصر الإدخال التي تتكوّن منها المحادثة.يمكن أن يكون كل عنصر:
  • message: رسالة محادثة تحتوي على الدور والمحتوى
  • function_call: طلب استدعاء دالة
  • function_call_output: المخرجات من استدعاء دالة
بالنسبة إلى الإدخال متعدد الوسائط، يمكن أن يكون message.content إما سلسلة نصية عادية أو مصفوفة من كتل المحتوى. بالنسبة إلى النماذج القادرة على التعامل مع الصور مثل متغيرات GPT-5.4، مرّر الصور على هيئة كتل input_image بدلًا من تضمين عناوين URL أو سلاسل Base64 مباشرة داخل النص العادي.مقاطع محتوى مثال:
  • { "type": "input_text", "text": "Describe this image" }
  • { "type": "input_image", "image_url": "https://example.com/image.jpg" }
  • { "type": "input_image", "image_url": "data:image/png;base64,..." }
​
instructions
string
تعليمات النظام للنموذج (المكافئة لرسالة النظام).
​
max_output_tokens
integer
الحد الأقصى لعدد الرموز المميزة المراد توليدها.
​
temperature
number
افتراضي:"1"
درجة الحرارة الخاصة بالعيننة بين 0 و2.
​
tools
array
قائمة بالأدوات التي قد يستدعيها النموذج.بالنسبة إلى أدوات image_generation المستضافة التي تستخدم نموذج أداة الصور الافتراضي أو تضبط صراحةً model: "gpt-image-2"، تزيل TokenLab الحقل غير المدعوم input_fidelity قبل تمرير الطلب، لأن GPT Image 2 يعالج مدخلات الصور أصلًا بدقة عالية. لا ترسل background: "transparent" لهذه الأداة؛ لا تزيله TokenLab بصمت لأن ذلك يغيّر دلالة الخرج.
​
stream
boolean
افتراضي:"false"
إذا كانت true، فسيعيد تدفقًا من الأحداث.
​
previous_response_id
string
معرّف استجابة سابقة لمتابعة المحادثة منها.
​
store
boolean
افتراضي:"true"
ما إذا كان سيتم تخزين الاستجابة لاسترجاعها لاحقًا.
​
metadata
object
بيانات وصفية تُضاف إلى الاستجابة لأغراض التتبع.
​
text
object
خيارات تهيئة توليد النص. يعتمد سلوك text.format على النموذج المحدد والمسار الموجَّه؛ ولا يُضمن أن يكون موحدًا عبر كل نموذج.
​
parallel_tool_calls
boolean
افتراضي:"true"
ما إذا كان يُسمح بعدة استدعاءات أدوات بالتوازي.
​
top_p
number
معامل أخذ العينات النووية (0-1).
​
reasoning
object
إعدادات الاستدلال للنماذج المفعّلة للاستدلال مثل متغيرات عائلة GPT-5.
  • effort (string): مستوى جهد الاستدلال (low، medium، high)

​
الاستجابة

​
id
string
المعرّف الفريد للاستجابة.
​
object
string
Always response.
​
created
integer
الطابع الزمني بنظام Unix عند إنشاء الاستجابة.
​
output
array
قائمة عناصر الإخراج التي تم إنشاؤها بواسطة النموذج.
​
usage
object
إحصاءات استخدام الرموز.
curl -X POST "https://api.tokenlab.sh/v1/responses" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": [
      {"type": "message", "role": "user", "content": "Hello!"}
    ],
    "max_output_tokens": 1000
  }'

{
  "id": "resp_abc123",
  "object": "response",
  "created": 1706000000,
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {"type": "text", "text": "Hello! How can I help you today?"}
      ]
    }
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12,
    "total_tokens": 22
  }
}