Documentation

API reference
POST/v1/chat/completions

Create Chat Completion

Creates a model response from conversation history with streaming, tools, and usage accounting.

ProtocolOpenAI Chat Completions
Reference categoryChat Completion

Compatible model examples

gpt-4ogpt-4.1gpt-5o3o4-mini
Keep the format. Choose your model.
cURL
curl -X POST https://api.routekey.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello from Route Key"
    }
  ],
  "stream": false
}'
Example only · no request is sent
المعلمات
الاسمالنوعمطلوبالوصف
modelstringنعمTarget model name from the Models page or model-list response.
messagesarray<object>نعمOpenAI-compatible chat messages for text endpoints.
temperaturenumberلاSampling temperature.
top_pnumberلاNucleus sampling value.
streambooleanلاEnable server-sent streaming responses when supported.
max_tokensintegerلاMaximum tokens for completion output.
toolsarray<object>لاTool definitions or function schemas supported by the selected model.
response_formatobjectلاOptional output format or response encoding.
الاستجابة
الاسمالنوعمطلوبالوصف
idstring-Response, task, or resource ID.
objectstring-Response object type.
createdinteger-Creation timestamp.
modelstring-Model used for the request.
choicesarray<object>-Candidate model outputs.
usageobject-Token usage statistics.
ملاحظات
  • OpenAI Chat Completions
  • تحافظ الصيغة المتوافقة على بنية SDK المعتادة.
Your applicationRouteKeyOpenAI

المفاهيم

المفاهيم الأساسية التي تحتاجها قبل إرسال أول طلب.

مفتاح API: بيانات اعتماد Route Key التي تُرسل في ترويسة Authorization.

العنوان الأساسي: نقطة الدخول المتوافقة التي يستقبلها SDK.

اسم النموذج: المعرّف الدقيق من كتالوج النماذج.

الفوترة: تحدد المجموعة ونوع الحصة السعر الفعلي للطلب.

النماذج

ابدأ بنموذج مدعوم منخفض التكلفة ثم وسّع السياق أو القدرة عند الحاجة.

الدردشة العامة: ابدأ بنموذج سريع منخفض التكلفة.

الاستدلال أو البرمجة: انتقل إلى نموذج استدلال أقوى عند الحاجة.

Move up for reasoning

Check group pricing before production

الأخطاء الشائعة

أخطاء شائعة في التوثيق والحصة وصيغة الطلب وكيفية معالجتها.

401

Authentication failed

Check that Authorization uses Bearer plus your Route Key API key.

403

No access or balance

Check key status, account balance, model access, and billing settings.

429

Quota or rate limit

Reduce concurrency, retry with backoff, or review account limits.

5xx

Upstream or routing failure

Retry later and inspect Usage Logs for route status and provider errors.