Skip to main content
كل مكتبة OpenAI رسمية تعمل؛ فقط base_url يتغير. الأمثلة تستخدم gpt-5.6-sol؛ لباقة Astra استخدم gpt-astra.

Chat Completions

base_url يجب أن يتضمن /v1 وألّا ينتهي بـ /. المكتبة تضيف /chat/completions تلقائياً.
الاستجابات تتبع مخطط OpenAI تماماً: id هو chatcmpl-...، usage يحتوي prompt_tokens وcompletion_tokens وcompletion_tokens_details.reasoning_tokens. تُحسب الحصة بالضبط من usage.total_tokens.

Responses API

Codex والـ SDKs الأحدث يستخدمان هذا البروتوكول. إعداد الاستدلال في reasoning.effort.

جهد الاستدلال

مع Chat Completions استخدم reasoning_effort (low, medium, high). إن لم تضبطه، تستخدم البوابة high. للمهام البسيطة اضبط low لتوفير الرموز:
reasoning_effort لـ Chat Completions فقط. مع Responses API استخدم reasoning: {"effort": ...}؛ إرسال reasoning_effort إلى /v1/responses يُرفض بـ “Unsupported parameter”.

البث

في الأسئلة الصعبة قد يفكر النموذج فترة قبل أول رمز. استخدم stream: true لعدم انقطاع الاتصال. stream_options.include_usage يجعل القطعة الأخيرة تحمل usage لتتمكن من تسوية الحصة بنفسك.

إرسال الصور (vision)

الصور تذهب في مصفوفة content، كرابط عام أو base64 للملفات المحلية.
الصور تكلّف رموزاً حسب الحجم. اقتص القسم المعني بدلاً من إرسال لقطة شاشة 4K كاملة.

النماذج والحصة عبر الواجهة البرمجية

subscription يُعيد الإجمالي في hard_limit_usd؛ usage يُعيد المستخدَم في total_usage، بـ سنتات (اقسم على 100 قبل المقارنة). صفحة التحقق تفعل هذا تلقائياً.