API reference¶

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

Base URL¶

https://api.claudin.io

توجد المسارات بنمط OpenAI تحت /v1.

المصادقة¶

أرسل مفتاح API الخاص بك مع كل طلب، كأحد الرؤوس التالية:

Authorization: Bearer YOUR_API_KEY

x-api-key: YOUR_API_KEY

النموذج¶

معرف النموذج	نافذة السياق
`claudinio`	256K رمز

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

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

الطريقة والمسار	الوصف
`POST /v1/chat/completions`	إكمال المحادثة — نقطة النهاية الأساسية
`POST /v1/completions`	إكمال النص القديم
`POST /v1/messages`	تنسيق رسائل Anthropic
`POST /v1/responses`	API الردود (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, وهكذا.

`max_tokens` والاستدلال¶

نماذج Claudinio تستدل قبل الإجابة، و رموز الاستدلال تُحتسب ضمن max_tokens — نفس الميزانية تغطي سلسلة التفكير الداخلية والرد المرئي. لذلك يمكن إنفاق max_tokens صغيرة بالكامل تقريبًا على الاستدلال، مما يترك الإجابة مقطوعة في منتصف الجملة.

لمنع ذلك، يتم رفع القيم الأقل من 4000 تلقائيًا إلى 4000. القيم الأكبر تُمرر كما هي، وحذف المعلمة جيد دائمًا.

إذا كنت تقوم بتحليل مخرجات منظمة (JSON, XML, تنسيق صارم)، تحقق من finish_reason قبل التحليل — "length" تعني أن الاستجابة وصلت إلى حد الرموز وهي غير مكتملة، لذا فإن فشل التحليل متوقع وليس مشكلة في النموذج:

choice = response.choices[0]
if choice.finish_reason == "length":
    ...  # truncated — retry with a larger max_tokens
data = json.loads(choice.message.content)

البث المباشر¶

اضبط "stream": true لتلقي أحداث مرسلة من الخادم بتنسيق البث المباشر لـ OpenAI (data: {...} أجزاء تنتهي بـ data: [DONE]).

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

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

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

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

الأخطاء¶

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

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

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

تفاصيل المزود مخفية عن قصد

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

الوصول إلى حد الميزانية¶

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

تحديد المعدل¶

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