الانتقال إلى المحتوى الرئيسي
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
  }
}