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

​
جسم الطلب

​
model
string
مطلوب
معرف النموذج المستخدم. راجع Models للاطلاع على الخيارات المتاحة.
​
messages
array
مطلوب
قائمة بالرسائل التي تشكل المحادثة.يحتوي كل كائن رسالة على:
  • role (string): system, user, أو assistant
  • content (string | array): محتوى الرسالة
عندما تكون content مصفوفة، يدعم AI Sonar كتلًا مُهيكلة متعددة الوسائط للنماذج المتوافقة:
  • 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 عامة. سيقوم AI Sonar بترجمة هذه الكتل الوسائطية إلى شكل الطلب الخاص بمزود الخدمة المطلوب للنموذج الفيزيائي الموجه.
​
temperature
number
افتراضي:"1"
درجة حرارة العينة بين 0 و2. القيم الأعلى تجعل المخرجات أكثر عشوائية.
​
max_tokens
integer
الحد الأقصى لعدد التوكنات التي سيتم توليدها.
​
stream
boolean
افتراضي:"false"
If true، سيتم إرسال دلتا الرسائل الجزئية كأحداث SSE.
​
stream_options
object
خيارات البث. اضبط include_usage: true لتلقي استخدام التوكنات في أجزاء البث.
​
top_p
number
افتراضي:"1"
معامل Nucleus sampling. نوصي بتغيير هذا أو temperature، وليس كليهما.
​
frequency_penalty
number
افتراضي:"0"
رقم بين -2.0 و2.0. القيم الإيجابية تعاقب التوكنات المكررة.
​
presence_penalty
number
افتراضي:"0"
رقم بين -2.0 و2.0. القيم الإيجابية تعاقب التوكنات الموجودة بالفعل في النص.
​
stop
string | array
حتى 4 تسلسلات تتوقف عندها الـ API عن توليد التوكنات.
​
tools
array
قائمة بالأدوات التي قد يستدعيها النموذج (استدعاء دوال).
​
tool_choice
string | object
يتحكم في كيفية استخدام النموذج للأدوات. الخيارات: auto, none, required, أو كائن أداة محدد.
​
parallel_tool_calls
boolean
افتراضي:"true"
ما إذا كان سيتم تمكين استدعاء الدوال المتوازي. اضبط على false لاستدعاء الدوال بشكل متسلسل.
​
max_completion_tokens
integer
الحد الأقصى للتوكنات للاستكمال. بديل لـ max_tokens، مفيد لعائلات النماذج الأحدث الممكّنة للتفكير.
​
reasoning_effort
string
مستوى جهد الاستدلال للنماذج الممكّنة للتفكير. الخيارات: low, medium, high.
​
seed
integer
بذرة عشوائية للعينة الحتمية.
​
n
integer
افتراضي:"1"
عدد الاستكمالات المراد توليدها (1-128).
​
logprobs
boolean
ما إذا كان سيتم إرجاع لوغاريتمات الاحتمالات.
​
top_logprobs
integer
عدد أعلى لوغاريتمات الاحتمالات المراد إرجاعها (0-20). يتطلب logprobs: true.
​
top_k
integer
معامل أخذ العينات Top-K (لنماذج Anthropic/Gemini).
​
response_format
object
مواصفات تنسيق الاستجابة. استخدم {"type": "json_object"} لوضع JSON. اعتبر {"type": "json_schema", "json_schema": {...}} كطريق بذل أقصى جهد يعتمد على النموذج المختار والسلوك الموجَّه.
​
logit_bias
object
تعديل احتمال ظهور توكنات محددة. اربط معرفات التوكن (كسلاسل) بقيم تحيّز من -100 إلى 100.
​
user
string
معرف فريد يمثل المستخدم النهائي لديك لأغراض مراقبة الإساءة.

​
الاستجابة

​
id
string
معرف فريد للاستكمال.
​
object
string
دائمًا chat.completion.
​
created
integer
طابع زمني بنظام Unix لوقت إنشاء الاستكمال.
​
model
string
النموذج المستخدم للاستكمال.
​
choices
array
قائمة بخيارات الاستكمال.يحتوي كل خيار على:
  • index (integer): مؤشر الخيار
  • message (object): الرسالة المولدة
  • finish_reason (string): سبب توقف النموذج (stop, length, tool_calls)
​
usage
object
إحصاءات استخدام التوكنات.
  • prompt_tokens (integer): التوكنات في المطالبة
  • completion_tokens (integer): التوكنات في الاستكمال
  • total_tokens (integer): إجمالي التوكنات المستخدمة
curl -X POST "https://api.aisonar.dev/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "temperature": 0.7,
    "max_tokens": 1000
  }'

​
مثال متعدد الوسائط

{
  "model": "gemini-2.5-pro",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Describe this video briefly." },
        { "type": "video_url", "video_url": { "url": "https://example.com/demo.mp4" } }
      ]
    }
  ],
  "max_tokens": 64
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1706000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 9,
    "total_tokens": 29
  }
}