قائمة المستندات

مرجع API

v1· آخر تحديث يوليو 2026

160+ نموذج · 12 عائلة نماذج

WayJet بوابة متوافقة مع OpenAI. وجّه أي SDK من OpenAI إلى عنوان URL الأساسي أدناه، واستخدم مفتاح API يبدأ بـ sk-، واستدعِ كل المزوّدين عبر واجهة API موحّدة.

12 عائلة نماذج

OpenAI وAnthropic وGemini وGroq وغيرها، خلف واجهة API واحدة.

متوافقة مع OpenAI

وجّه أي SDK من OpenAI إلى عنوان URL الأساسي — دون تغيير الكود.

البث

بث SSE رمزًا برمز في chat completions جاهز للاستخدام.

المفاتيح والميزانيات

مفاتيح بصلاحيات محدّدة، وحدود إنفاق لكل فترة، وتتبّع للاستخدام.

استدعِ GET /v1/models بمفتاحك لعرض النماذج التي تقدّمها لك البوابة.

مقدمة#

تذهب كل الطلبات إلى عنوان URL أساسي واحد. ولأن البوابة تتحدث بصيغة OpenAI، تعمل حزم SDK والأدوات الحالية دون تغيير — تبدّل فقط عنوان URL الأساسي والمفتاح.

https://api.wayjet.ai/v1

المصادقة#

صادِق باستخدام رمز Bearer في ترويسة Authorization. أنشئ مفتاحًا يبدأ بـ sk- في صفحة مفاتيح API — يظهر السرّ مرة واحدة فقط، فاحفظه في مكان آمن.

header
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
لا تكشف أي مفتاح في كود يعمل لدى العميل. استدعِ البوابة من خادمك، أو عبر وسيط (proxy).
أنشئ مفتاح API

بداية سريعة#

أرسل أول طلب chat completion. اضبط WAYJET_API_KEY على مفتاح API الخاص بك وشغّله كما هو، أو استبدل gpt-5.1 بأي معرّف نموذج من GET /v1/models، الذي يعرض النماذج التي يستطيع مفتاحك استدعاءها.

curl https://api.wayjet.ai/v1/chat/completions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
جرّبه في ساحة التجربة

Chat completions#

POST /v1/chat/completions — نقطة النهاية الأساسية. تتبع الطلبات والاستجابات مخطط OpenAI؛ وتضيف البوابة provider وcache_status إلى الاستجابة.

المعاملالنوعالوصف
model*stringمعرّف نموذج من GET /v1/models (‏gpt-5.1 في الأمثلة)
messages*arrayرسائل المحادثة (role + content)
streambooleanإرجاع الرموز كأحداث server-sent events
temperaturenumberدرجة حرارة أخذ العينات، 0–2 (الافتراضي 1)
max_tokensintegerأقصى عدد من الرموز يُولَّد
top_pnumberكتلة الاحتمال في أخذ العينات النووي
toolsarrayتعريفات الدوال/الأدوات التي يمكن للنموذج استدعاؤها
tool_choicestring | objectفرض اختيار الأداة أو تقييده
response_formatobjectمثل { "type": "json_object" } لوضع JSON
reasoning_effortstringlow · medium · high (نماذج الاستدلال)
stopstring | arrayحتى 4 تسلسلات إيقاف
seedintegerأخذ عينات حتمي قدر الإمكان
providerstringخاص بالبوابة — يثبّت الطلب على مزوّد واحد

* مطلوب

البث#

اضبط stream: true لتلقّي الرموز كأحداث server-sent events. كل حدث سطر data: يحمل جزءًا جديدًا؛ وينتهي البث بـ data: [DONE].

curl https://api.wayjet.ai/v1/chat/completions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'
# → server-sent events: lines of  data: {...}  terminated by  data: [DONE]

التخزين المؤقت للمطالبات#

تخزّن بعض الجهات المزوّدة بداية المطالبة التي رأتها مؤخرًا، وتتقاضى أقل لإعادة معالجتها. لدى OpenAI وGemini وDeepSeek يحدث هذا تلقائيًا: لا يحتاج إلى أي معامل منك، ولا تستطيع أنت ولا WayJet إيقافه. أما Anthropic فلا تخزّن إلا عندما يطلب الطلب ذلك.

مع مفتاح المنصة، لا تحترم WayJet ‏`cache_control` إلا للحسابات المثبّتة على مساحة عمل Anthropic خاصة بها. وفي غير ذلك يُقبل المؤشر ثم يُزال قبل وصول الطلب إلى Anthropic. ينجح الاستدعاء مع ذلك، لكن usage لا يحمل أي رموز تخزين مؤقت، وتُحتسب كل رموز الإدخال بسعر الإدخال الكامل، وهو ما تتقاضاه Anthropic عنها أيضًا. ومع مفتاح Anthropic الخاص بك، يمرّ المؤشر دائمًا.

كل مزوّد يرسم حدود التخزين المؤقت عند عميله هو. ومع مفتاح منصة WayJet، يكون هذا العميل هو WayJet — لذا تتشارك طلباتك لدى المزوّدين الثلاثة التلقائيين مساحة تخزين واحدة مع حسابات WayJet الأخرى طوال مدة إعادة الاستخدام أدناه. تُرجع البوابة cache_status في chat completions، لكنه يبيّن هل أُعيد استخدام بادئة ما، لا لمن كانت.

المزوّدالتخزين المؤقتحدود التخزينمدة إعادة الاستخدام
OpenAIتلقائيالمؤسسة — مؤسسة WayJet مع مفتاح المنصةحتى 30 دقيقة
Geminiتلقائيمشروع Google Cloud — مشروع WayJet مع مفتاح المنصةحتى 24 ساعة
DeepSeekتلقائيالحساب — حساب WayJet مع مفتاح المنصةمن ساعات إلى أيام
Anthropicعند الطلب (cache_control)، بمفتاحك الخاص أو حساب مثبّتحسابك الخاص (BYOK) أو مساحة العمل المثبّتة لك5 دقائق
Claude على Bedrock / Vertexعند الطلب، ببيانات اعتمادك فقطحساب AWS / مشروع GCP5 دقائق

ما الذي يعنيه التخزين المشترك وما لا يعنيه

لا يعبر أي محتوى من المطالبات أو الردود عبر التخزين المؤقت للمطالبات. إصابة التخزين تعني أن المزوّد يعيد معالجة بادئة أرسلها المستدعي نفسه، بتكلفة أقل — ولا تسلّم نصّ أحد إلى أحد. ما تكشفه المساحة المشتركة هو التوقيت: من يملك بادئة مطابقة تمامًا قد يستنتج، نظريًا، من استجابة أسرع أو أرخص أنها أُرسلت مؤخرًا. وعليه أن يعرف البادئة أولًا، وهذا ما يحدّ من الخطر.

ننشر هذا لأنك لا تستطيع ملاحظته بنفسك. تُخفي WayJet عمدًا أيّ مزوّد خدم الطلب، فلا شيء في واجهة API أو لوحة التحكم سيخبرك أين تقع حدود التخزين لدى المزوّد. وإن كنت تعيد بيع الاستدلال لمستخدميك، فهذا هو الجواب على السؤال نفسه في المستوى التالي.

إذا كنت تحتاج إلى مساحة تخزين خاصة بك

هناك طريقان، وهما الطريقان الصادقان الوحيدان — لا يوجد على مفتاح المنصة أي إعداد لكل عميل يحقق ذلك:

  • استخدم مفتاحك الخاص. أضف بيانات اعتماد المزوّد الخاصة بك، فتمرّ حركتك عبر حسابك لدى المزوّد، وتُرسم حدود التخزين عندك. يعمل هذا مع كل المزوّدين، وهو الحل الكامل.
  • اطلب مساحة عمل Anthropic. لـ Anthropic تحديدًا، يمكننا تثبيت حسابك على مساحة عمل Anthropic خاصة به، فيصبح تخزين مطالباتك لك وحدك وأنت تواصل استخدام مفتاح المنصة. يتم ذلك عند الطلب ولكل حساب على حدة — لا يوجد مفتاح خدمة ذاتية، ولا ينطبق على Claude عبر Bedrock أو Vertex، إذ لا مقابل لذلك فيهما. وهو أيضًا ما يفعّل تخزين Anthropic المؤقت لحساب يستخدم مفتاح المنصة.

التضمينات#

POST /v1/embeddings — يحوّل النص إلى متجهات للبحث وRAG. يقبل سلسلة نصية أو مصفوفة من السلاسل.

curl https://api.wayjet.ai/v1/embeddings \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-embedding-model",
    "input": "The quick brown fox"
  }'

الصوت (الكلام)#

POST /v1/audio/speech يحوّل النص إلى كلام (يُحتسب لكل حرف إدخال)، وPOST /v1/audio/transcriptions يحوّل ملفًا صوتيًا مرفوعًا إلى نص (يُحتسب لكل دقيقة صوت). كلاهما متوافق مع OpenAI.

تحويل النص إلى كلام

curl https://api.wayjet.ai/v1/audio/speech \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-tts-model",
    "input": "The quick brown fox jumped over the lazy dog.",
    "voice": "alloy"
  }' \
  --output speech.mp3

تحويل الكلام إلى نص

ارفع الملف بصيغة multipart/form-data. اضبط response_format على srt أو vtt أو verbose_json لتحصل على ترجمة مصحوبة بطوابع زمنية بدلًا من نص عادي.

curl https://api.wayjet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -F "model=your-stt-model" \
  -F "file=@audio.mp3" \
  -F "response_format=json"   # json (default) · text · srt · vtt · verbose_json

النماذج#

GET /v1/models يُرجع الكتالوج المتاح لمفتاحك، مع سعر كل نموذج وقدراته. استخدم id من هذه القائمة كقيمة model في كل مثال في هذه الصفحة.

shell
curl https://api.wayjet.ai/v1/models \
  -H "Authorization: Bearer $WAYJET_API_KEY"
تصفّح كل النماذج

أدوات سطر الأوامر (Claude Code وCodex)#

تتحدث البوابة بواجهة Messages من Anthropic ‏(POST /v1/messages) وواجهة Responses من OpenAI ‏(POST /v1/responses)، لذا تتصل أدوات البرمجة الشائعة بـ WayJet مباشرةً وتُحتسب على مفتاحك الخاص — دون وسيط ودون SDK لكل مزوّد. وجّه كل أداة إلى نموذج يمكنك استدعاؤه.

ما هو الـ squad؟

الـ squad هو اسم النموذج الذي تستدعيه: منتج له اسم على البوابة ويجيب باسمه. استخدم اسم الـ squad أينما يُطلب اسم نموذج. يعرض GET /v1/models ما يستطيع مفتاحك استدعاءه. أسماء النماذج في الإعدادات أدناه هي squads، فتعمل كما هي.

Claude Code

أضِف إلى ~/.claude/settings.json. يُمرَّر المفتاح في ANTHROPIC_AUTH_TOKEN (أو في ANTHROPIC_API_KEY كترويسة x-api-key)، ويُربط كل مستوى بنموذج تختاره.

~/.claude/settings.json
{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wayjet.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Codex

يستخدم Codex واجهة Responses من OpenAI افتراضيًا — لا حاجة إلى wire_api = "chat".

~/.codex/config.toml
model = "gpt-5.1"
model_provider = "wayjet"

[model_providers.wayjet]
name = "WayJet"
base_url = "https://api.wayjet.ai/v1"
wire_api = "responses"
~/.codex/auth.json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-key"
}

يرسل Claude Code وCodex كل طلب إلى النموذج الوحيد الذي يسمّيانه.

الأخطاء#

تستخدم الأخطاء رموز حالة HTTP القياسية وبنية على نمط OpenAI.

json
{
  "error": {
    "message": "Incorrect API key provided.",
    "type": "authentication_error",
    "code": null,
    "param": null
  }
}
الحالةالنوعالمعنى
200OKنجح الطلب
400invalid_request_errorطلب غير صالح الصياغة أو معاملات غير صالحة
401authentication_errorمفتاح API مفقود أو غير صالح أو ملغى
403permission_errorلا يُسمح لهذا المفتاح بتنفيذ هذا الإجراء
404not_found_errorنموذج أو مورد غير معروف
429rate_limit_errorتجاوز حد المعدل، أو تجاوز الميزانية
500api_errorخطأ غير متوقع في البوابة
اعرض استخدامك وحدودك

نقاط النهاية#

نقاط النهاية التي يمكنك استدعاؤها بمفتاح API. تُدار المفاتيح والاستخدام والميزانيات من لوحة التحكم.

الطريقةنقطة النهايةالوصف
POST/v1/chat/completionsChat completion (مع البث ودونه)
POST/v1/messagesصيغة Messages من Anthropic (مع البث ودونه؛ x-api-key أو Bearer)
POST/v1/responsesصيغة Responses من OpenAI (مع البث ودونه). بلا حالة: يُتجاهل previous_response_id، لذا أرسل المحادثة كاملة في كل مرة
GET/v1/generationتكلفة طلب واحد ورموزه، عبر X-Wayjet-Request-Id الخاص به (?id=)
POST/v1/embeddingsإنشاء التضمينات
POST/v1/audio/speechتحويل النص إلى كلام (مخرَج صوتي)
POST/v1/audio/transcriptionsتحويل الكلام إلى نص (تفريغ)
GET/v1/modelsعرض النماذج المتاحة

سجل التغييرات#

أبرز التغييرات على واجهة API العامة. يبقى عنوان URL الأساسي /v1 حفاظًا على التوافق مع الإصدارات السابقة.

  • يوليو 2026أدوات سطر الأوامر: استخدم Claude Code ‏(/v1/messages) وCodex ‏(/v1/responses) مباشرةً. إحصاءات التوليد (/v1/generation).
  • يوليو 2026الصوت: تحويل النص إلى كلام (/v1/audio/speech) وتحويل الكلام إلى نص (/v1/audio/transcriptions، بصيغ srt/vtt/verbose_json).
  • يونيو 2026إضافة reasoning_effort.
  • مايو 2026نقطة نهاية التضمينات ووضع JSON ‏(response_format).
  • أبريل 2026البث (SSE) في chat completions؛ تثبيت المزوّد.
سجل التغييرات الكامل