التوثيق ‹ الموارد ‹ سجل التغييرات

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

كل التطورات التقنية لواجهة API : نقاط نهاية جديدة، تغييرات في السلوك، إصلاحات. إعلانات المنتج موجودة في آخر المستجدات.

التزامنا بالتوافق

لا نُدخل قطيعة صامتة. يمكن إضافة حقل إلى استجابة في أي وقت (يجب أن تتجاهل شيفرتكم الحقول غير المعروفة) ؛ لن يُحذف حقل ولن يتغير معناه أبدًا دون إعلان مسبق هنا وفي آخر المستجدات.

2026-08 : API الملفات وAPI Responses#

أُضيف

  • /v1/files: رفع، عرض، استرجاع، حذف مستندات؛ يُستخرج النص عند التسجيل ويمكن استرجاعه عبر GET /v1/files/{id}/content (الدليل).
  • POST /v1/responses: صيغة Responses من OpenAI، مع بث مباشر (الدليل).

مرفوضة صراحةً (بدل تجاهلها بصمت)

  • previous_response_id وstore: واجهة API عديمة الحالة.
  • أدوات مدمجة (web_search، code_interpreter...).
  • يُسجَّل الملف غير القابل للقراءة بالحالة status: "error" والسبب الدقيق، أبدًا بمحتوى فارغ.

2026-08 : وضع التفكير#

أُضيف

  • reasoning_effort (minimal / low / medium / high) وthinking (enabled / disabled) على /v1/chat/completions؛ انظروا وضع التفكير.
  • أصبح الحقل thinking في واجهة Anthropic مُعتمَدًا فعليًا (كان يُقبَل ثم يُتجاهل)، بما في ذلك budget_tokens.
  • كتل محتوى thinking في استجابات Anthropic، و usage.cache_read_input_tokens.
  • usage.completion_tokens_details.reasoning_tokens: ما كلّفه التفكير (مُدرَج بالفعل ضمن completion_tokens، لا يُفوتَر إضافيًا أبدًا).

2026-08 : FIM، البادئة والتخزين المؤقت للسياق#

أُضيف

  • POST /v1/completions: إكمال FIM (prompt + suffix)، للإكمال التلقائي في المحرر.
  • إكمال البادئة: تُستكمَل آخر رسالة assistant مُعلَّمة بـ"prefix": true بدل أن تُتبَع برسالة جديدة.
  • التخزين المؤقت للسياق يُفوتَر بسعر مخفّض، مع الحقول prompt_cache_hit_tokens، prompt_cache_miss_tokens وprompt_tokens_details.cached_tokens في usage.

عُدِّل

  • تحتوي كتلة usage من الآن فصاعدًا دائمًا على حقول التخزين المؤقت (بقيمة صفر حين لا يوفرها المحرك). حقول مُضافة، لا شيء حُذف.

2026-08 : الرؤية#

أُضيف

  • تقبل النماذج الثلاثة صورًا في الإدخال، على الواجهتين : كتل image_url (صيغة OpenAI) وكتل image بصيغة base64 أو رابط (صيغة Anthropic). انظروا الرؤية.
  • صيغ PNG وJPEG وWebP وGIF؛ 8 ميغابايت لكل صورة؛ 8 صور لكل طلب.
  • تُفوتَر الصور كرموز إدخال، بالسعر العادي للنموذج.

2026-08 : الإصدار الأولي#

أُضيف

  • POST /v1/chat/completions: متوافقة مع OpenAI، مع البث المباشر ودونه.
  • GET /v1/models: كتالوج النماذج، مع نافذة السياق وأقصى إخراج.
  • GET /v1/user/balance: رصيد المحفظة بالدينار.
  • POST /anthropic/v1/messages: متوافقة مع Anthropic Messages، مع بث مباشر كامل قائم على الأحداث واستدعاء الأدوات.
  • GET /anthropic/v1/models.
  • نماذج mina-flash، mina-low، mina-full.
  • مفاتيح API بصيغة zir_ai_ + 48 حرفًا سداسي عشريًا، مع إلغاء فعّال في أقل من دقيقة.
  • مستويات معدل trial / standard / pro، مع عزل حسب المستخدم النهائي عبر user (OpenAI) أو metadata.user_id (Anthropic).
  • ترويسات X-Request-Id، X-RateLimit-Limit-Requests، X-RateLimit-Remaining-Requests.
  • إخراج JSON عبر response_format: {"type": "json_object"}.
  • استدعاء الأدوات على الواجهتين، بما في ذلك في البث المباشر.
  • محفظة مسبقة الدفع بالدينار، بلا اشتراك. تظهر وسائل الدفع المقترحة في صفحة Top up على المنصة.

سلوكيات يجب معرفتها

  • يُعيد حقل model في الاستجابات دائمًا اسم Mina المطلوب.
  • الطلبات التي تفشل دون إنتاج نص لا تُفوتَر.
  • حين لا يُعيد محرك ما حقل usage في البث المباشر، يُقدَّر الاستهلاك ويُشار إليه كتقدير في Usage.
  • أثناء انتظار محرك، يبقى الاتصال محفوظًا : تعليقات SSE : keep-alive (واجهة OpenAI)، أحداث ping (واجهة Anthropic).

غير متاح بعد

  • مستندات PDF مُرسَلة كما هي (كتل document).
  • response_format: {"type": "json_schema"}؛ استخدموا json_object.
  • cache_control (وسم يدوي للذاكرة المؤقتة) يُقبَل ثم يُتجاهل: التخزين المؤقت تلقائي.
  • n > 1، logprobs، seed مضمون.

الإعدادات

التخصيص

استجابة API