مستندات المطورين

اتصل مرة واحدة ووجّه كل نموذج.

مرجع عملي لطلبات API المتوافقة مع OpenAI ونقاط نهاية المورّدين.

تجريبي5 {{count}} نموذجًا مفهرسًاآخر تحديث 00:00:00
30نقاط نهاية النماذج
8فئات المورّدين
مفتاح APIالمصادقة
Integration guideConnect apps and coding agentsOne API key and compatible gateway for SDKs, Codex, Claude Code, Gemini CLI, and Cursor.Open guide
POSTOpenAI/chat/completions

Create Chat Completion

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

ترويسة Authorization
أرسل مفتاح Route Key بعد كلمة Bearer.
Bearer API key
نوع المحتوى

application/json

النموذج

gpt-4o, gpt-4.1, gpt-5, o3, o4-mini

مثال الطلب
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
}'
مثال الاستجابة
{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 0,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 3,
    "total_tokens": 11
  }
}
مثال cURL
curl -X POST 'https://api.routekey.ai/v1/chat/completions' \
  -H 'Bearer API key'
  -H 'Content-Type: application/json'
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello from Route Key"
    }
  ],
  "stream": false
}'
المعلمات
الاسمالنوعمطلوبالوصف
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 المعتادة.

المفاهيم

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

مفتاح 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.