مرجع API¶

Claudin.io هي واجهة برمجة تطبيقات متوافقة مع OpenAI. إذا كنت قد استخدمت واجهة برمجة تطبيقات OpenAI من قبل، فكل شيء هنا مألوف — فقط وجّه عنوان URL الأساسي الخاص بـ Claudin.io واستخدم نموذج claudinio.

عنوان URL الأساسي¶

https://api.claudin.io

المسارات على نمط OpenAI تكون تحت /v1.

المصادقة¶

أرسل مفتاح واجهة برمجة التطبيقات الخاص بك مع كل طلب، سواء كرأس:

Authorization: Bearer YOUR_API_KEY

x-api-key: YOUR_API_KEY

النموذج¶

معرف النموذج	نافذة السياق
`claudinio`	256 ألف رمز (token)

استخدم claudinio في كل مكان. (بعض العملاء يتوقعون صيغة provider/model — بالنسبة لهؤلاء، استخدم claudinio/claudinio.)

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

الطريقة والمسار	الوصف
`POST /v1/chat/completions`	إكمال المحادثات — نقطة النهاية الرئيسية
`POST /v1/completions`	إكمال النصوص القديم
`POST /v1/messages`	تنسيق رسائل Anthropic
`POST /v1/responses`	واجهة استجابات واجهة برمجة التطبيقات (Codex)
`POST /v1/embeddings`	تضمينات النصوص
`GET /v1/models`	عرض النماذج المتاحة

إكمال المحادثات¶

curl https://api.claudin.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claudinio",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Write a haiku about proxies."}
    ],
    "temperature": 0.7
  }'

الخيارات القياسية لواجهة برمجة تطبيقات OpenAI مدعومة: messages, temperature, top_p, max_tokens, stream, stop, tools / tool_choice (استدعاء الدوال), response_format, وغيرها.

البث¶

عيّن "stream": true لتلقي أحداث من الخادم (server-sent events) بصيغة البث الخاصة بـ OpenAI (أجزاء data: {...} تنتهي بـ data: [DONE]).

استدعاء الأدوات / الدوال¶

يدعم claudinio استدعاء الأدوات. مرر tools واقرأ tool_calls من الرد، تمامًا كما في واجهة برمجة تطبيقات OpenAI. هذا ما يجعله يعمل داخل المحررات الوكيلة مثل Claude Code وKilo وCursor.

الإدخال متعدد الوسائط¶

claudinio هو نموذج نصي، لكن Claudin.io يتعامل بشفافية مع كتل الصور والصوت والفيديو: إذا أرسلتها، يقوم البروكسي بتحويلها إلى أوصاف/نسخ نصية قبل أن يراها النموذج. لا تحتاج إلى فعل أي شيء خاص — أرسل كتل المحتوى القياسية لـ OpenAI وستعمل تلقائيًا.

الأخطاء¶

تتبع الأخطاء هيكل أخطاء OpenAI:

{ "error": { "message": "…", "type": "…", "code": "…" } }

الحالة	المعنى	ما يجب فعله
`401`	مفتاح واجهة برمجة التطبيقات غير صالح أو مفقود	تحقق من المفتاح ورأس المصادقة
`403`	نقطة النهاية غير مسموح بها	استخدم أحد المسارات المدعومة `/v1/*`
`429`	تم تجاوز حد الميزانية أو تقييد المعدل	انتظر إعادة تعيين النافذة أو قم بالترقية
`400`	طلب غير صحيح	تحقق من JSON / المعاملات الخاصة بك
`5xx`	خلل من المزود/الموفر العلوي	أعد المحاولة مع تأخير (backoff)

تفاصيل المزود مخفية حسب التصميم

يتم تنقية رسائل الأخطاء حتى لا تكشف عن مزود النموذج الأساسي. سترى دائمًا أخطاء تحمل علامة Claudin.io التجارية وهيكل OpenAI.

تجاوز حد الميزانية¶

عند استنفاد حماية الإنفاق للنافذة الحالية، تُرجع الطلبات خطأ في الميزانية (عادةً 429). تعرض لوحة التحكم الخاصة بك وقت إعادة التعيين الدقيق والميزانية المتبقية. راجع الخطط والحدود لمعرفة كيفية عمل النوافذ.

تقييد المعدل (Rate limiting)¶

لا يقوم Claudin.io بحظر عادي للاستخدام العادي. معدلات الطلبات المسيئة يتم إبطاؤها (تقييد شفاف) بدلاً من رفضها، لذلك لا يتعرض العملاء ذوو السلوك الجيد للعقاب. عمليًا، لا تحتاج إلى فعل أي شيء — فقط أعد المحاولة عند ظهور 429 النادر.