Chat Completions API

نقطة النهاية

POST https://api.barqapi.com/v1/chat/completions

جسم الطلب

المعامل	النوع	مطلوب	الوصف
model	string	✅ نعم	معرف النموذج
messages	array	✅ نعم	مصفوفة رسائل مع role و content
temperature	number	لا	درجة حرارة العينة (0–2). الافتراضي: 1
max_tokens	integer	لا	الحد الأقصى للرموز في الاستجابة
stream	boolean	لا	تمكين البث المباشر SSE. الافتراضي: false

مثال على الطلب

{
  "model": "gpt-4o",
  "messages": [
    {"role": "system", "content": "أنت مترجم عربي-إنجليزي مفيد."},
    {"role": "user", "content": "ترجم: 'Welcome to Saudi Arabia'"}
  ]
}

مثال على الاستجابة

{
  "id": "chatcmpl-abc123",
  "model": "gpt-4o",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "مرحباً بكم في المملكة العربية السعودية"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 12,
    "total_tokens": 37
  }
}