الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
responses
curl -X POST "https://api.lemondata.cc/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_at": 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
  }
}
تعد واجهة برمجة تطبيقات الاستجابات (Responses API) هي واجهة برمجة تطبيقات المحادثة الأحدث من OpenAI التي تحافظ على الحالة (stateful). يدعم LemonData هذا التنسيق للنماذج المتوافقة.

​
Request Body

​
model
string
مطلوب
معرف النموذج المراد استخدامه. راجع Models للخيارات المتاحة.
​
input
array
مطلوب
قائمة من عناصر المدخلات التي تتكون منها المحادثة.يمكن أن يكون كل عنصر:
  • message: رسالة محادثة تحتوي على الدور (role) والمحتوى (content)
  • function_call: طلب استدعاء وظيفة (function call)
  • function_call_output: مخرجات من استدعاء وظيفة
​
instructions
string
تعليمات النظام للنموذج (تعادل رسالة النظام).
​
max_output_tokens
integer
الحد الأقصى لعدد الـ tokens المراد إنشاؤها.
​
temperature
number
افتراضي:"1"
درجة حرارة أخذ العينات (Sampling temperature) بين 0 و 2.
​
tools
array
قائمة بالأدوات التي قد يستدعيها النموذج.
​
stream
boolean
افتراضي:"false"
إذا كانت القيمة true، فسيتم إرجاع تدفق (stream) من الأحداث.
​
previous_response_id
string
معرف استجابة سابقة لمواصلة المحادثة منها.
​
store
boolean
افتراضي:"true"
ما إذا كان سيتم تخزين الاستجابة لاستردادها لاحقاً.
​
metadata
object
بيانات وصفية (Metadata) لإرفاقها بالاستجابة لأغراض التتبع.
​
text
object
خيارات تكوين إنشاء النصوص.
​
parallel_tool_calls
boolean
افتراضي:"true"
ما إذا كان سيتم السماح باستدعاءات أدوات متعددة بشكل متوازٍ.
​
top_p
number
معلمة أخذ عينات النواة (Nucleus sampling) بين (0-1).
​
reasoning
object
تكوين التفكير (Reasoning) لنماذج o1/o3.
  • effort (string): مستوى جهد التفكير (low, medium, high)

​
Response

​
id
string
معرف فريد للاستجابة.
​
object
string
دائماً response.
​
created_at
integer
طابع زمني Unix لوقت إنشاء الاستجابة.
​
output
array
قائمة بعناصر المخرجات التي أنشأها النموذج.
​
usage
object
إحصائيات استخدام الـ tokens.
curl -X POST "https://api.lemondata.cc/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_at": 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
  }
}