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

الطلب الذي يتضمن web_search: true يسمّي مصادره: يسرد sources على /v1/chat/completions و/v1/messages النتائج التي أُعطيت للنموذج، وعلى /v1/chat/completions يحدد annotations موضع استشهاد الإجابة بكل منها. بحث ويب مدمج

web_search: true على /v1/chat/completions و/v1/messages يجري بحثاً في الويب قبل أن يجيب النموذج ويعطيه النتائج كمصادر مرقمة. الطلب الذي وجد نتائج يستهلك عملية بحث واحدة من مخصصاتك اليومية. وإذا لم يتبق شيء يُجاب عن الطلب بلا بحث. بحث ويب مدمج

البث الذي ينقطع من جهة الخادم يُحاسَب على الاستخدام المُبلَّغ عنه حتى تلك النقطة. ويعود باقي الحجز إلى رصيدك.

يجيب shannon-coder-1 على /v1/responses كما يفعل على نقطتي النهاية الأخريين. أدوات البرمجة بسطر الأوامر

مفتاح API الذي جرى تدويره يتوقف عن العمل فوراً.

POST /v1/tokenize وPOST /v1/messages/count_tokens: عدّ tokens مجاني للنماذج المفتوحة الأوزان المستضافة. عدّ الـ tokens

التخزين المؤقت للمطالبات على النماذج المفتوحة الأوزان المستضافة. تُحاسَب المدخلات المخبأة بنسبة 25% من سعر المدخلات وتُعرض في usage على نقاط النهاية الثلاث: prompt_tokens_details.cached_tokens وinput_tokens_details.cached_tokens وcache_read_input_tokens. يعرض GET /v1/models القيمتين pricing.cached_input_per_million_usd وcapabilities.prompt_caching لهذه النماذج. التخزين المؤقت للمطالبات

النماذج المفتوحة الأوزان المستضافة: tool_choice المفروض (required أو دالة مسماة) ينتج استدعاء أداة. استدعاء الدوال

تقبل النماذج المفتوحة الأوزان المستضافة رسالة system ليست أول رسالة في المحادثة.

يمكن الوصول إلى API كخدمة onion على Tor وعبر عنوان I2P. تحمل ردود api.shannon-ai.com العنوانين في الترويستين Onion-Location وX-I2P-Location. نقاط نهاية مشفّرة وعبر Tor وI2P

نموذجان جديدان shannon-3.1 وshannon-3.1-pro، يسردهما GET /v1/models. النماذج والأسعار

الطلب المبثوث الذي ينقطع عنه العميل يستمر حتى نهايته ويُحتسب. وقبل ذلك كانت الإجابة تتوقف عند الانقطاع.

تظهر الطلبات إلى /v1/responses في سجل الاستخدام.

تطبّق النماذج المفتوحة الأوزان المستضافة حقول أخذ العينات: temperature وtop_p وseed وstop وmax_tokens على /v1/chat/completions؛ وtemperature وtop_p وstop_sequences على /v1/messages؛ وtemperature وtop_p وmax_output_tokens على /v1/responses. Chat Completions

يعرض سجل الاستخدام تكلفة بالدولار الأمريكي لكل استدعاء وكإجمالي.

قيمة model التي ليست معرّفاً منشوراً يُجاب عنها بـ 400 والنوع invalid_request_error والرسالة unknown model: <id> على نقاط النهاية الثلاث. وقبل ذلك كان shannon-1.6-lite يجيب عن مثل هذا الطلب. النماذج والأسعار

يقبل /v1 مفتاح API فقط. ولا يُقرأ هناك ملف تعريف ارتباط تسجيل الدخول الخاص بالموقع. المصادقة

الحماية من الإغراق: 120 طلباً في الدقيقة لكل حساب على نقاط نهاية التوليد الثلاث. الحدود والرصيد

عندما يعجز النموذج عن الإجابة، يحمل الخطأ الرسالة الثابتة The model backend failed to answer. Please retry. وفحص الرصيد الذي يتعذر إجراؤه يُجاب عنه بـ 503 والنوع api_error. معالجة الأخطاء

الطلب غير المبثوث الذي يفشل يعيد حجزه إلى رصيدك.

يعرض GET /v1/models القيمة capabilities.reasoning_effort لكل نموذج. جهد الاستدلال

النماذج المفتوحة الأوزان المستضافة: الطلب غير المبثوث الذي لا يتلقى إجابة ينتهي بـ 504 والنوع api_error. والنتيجة الفارغة هي 502. معالجة الأخطاء

تقبل النماذج المفتوحة الأوزان المستضافة المدخلات التي يقبلها النموذج المسمى. الصورة المرسلة إلى معرّف نصي فقط يُجاب عنها بـ 400 و<id> does not accept image input. وresponse_format على معرّف بلا مخرجات منظمة يُجاب عنه بـ 400. يعرض GET /v1/models القيم capabilities.vision وresponse_format وjson_schema لكل معرّف. الصور والملفات

الردود غير المبثوثة تحمل نص الاستدلال: reasoning_content في رسالة /v1/chat/completions، وكتلة thinking قبل النص على /v1/messages. جهد الاستدلال

أسعار جديدة للنماذج المفتوحة الأوزان المستضافة، تبدأ من $0.50 لكل 1M tokens مدخلة و$2.00 لكل 1M tokens مخرجة. النماذج والأسعار

للنماذج المفتوحة الأوزان المستضافة معرّف واحد لكل نموذج، اثنا عشر معرّفاً في المجموع. النماذج والأسعار

مخرجات منظمة على shannon-3 وshannon-3-pro وshannon-3.1 وshannon-3.1-pro. يعرض GET /v1/models القيمة capabilities.json_schema: true لها. مخرجات منظمة

يقرأ /v1/responses الحقل text.format (json_object أو json_schema) للمخرجات المنظمة. Responses API

يعيد /v1/responses استدلال نماذج Shannon: عنصر مخرجات reasoning قبل عنصر message، وأحداث البث response.reasoning_summary_text.delta وresponse.reasoning_summary_text.done. Responses API

الحقل model في الرد هو المعرّف المنشور على كل نقطة نهاية. ويحمل كائن Responses الحقلين model وcreated_at.

يعرض GET /v1/models نافذة السياق لكل نموذج. النماذج والأسعار

تجيب النماذج المفتوحة الأوزان المستضافة على /v1/messages و/v1/responses كما على /v1/chat/completions، مع توجيهات النظام واستدعاءات الأدوات. يقبل /v1/messages الحقل thinking، وreasoning_effort حقل في الطلب. النماذج والأسعار

تتبع نصوص الأخطاء على /v1 أشكال حزم SDK: كائن error فيه type وmessage على نقاط النهاية بصيغة OpenAI، والكائن نفسه داخل {"type": "error"} على /v1/messages. معالجة الأخطاء

إبقاء الاتصال حياً في عمليات البث المفتوحة كل 15 ثانية: سطر تعليق : ping على /v1/chat/completions، وحدث event: ping على /v1/messages. البث

تبدأ معرّفات استدعاءات الأدوات بـ call_ على /v1/chat/completions و/v1/responses، وبـ toolu_ على /v1/messages. استدعاء الدوال

/v1/responses: القيمة الافتراضية لـ stream هي false. Responses API

يُقبل max_completion_tokens اسماً آخر لـ max_tokens على /v1/chat/completions. Chat Completions

يحمل الحدث response.completed في بث Responses المصفوفة output. Responses API

تحمل عناصر GET /v1/models الحقول display_name وcontext_window وmax_output_tokens وpricing وcapabilities وendpoints. النماذج والأسعار

كل رد يحمل x-request-id، وتُعاد القيمة التي ترسلها. يمكن أن تصل نصوص الطلبات إلى 32 MiB.

يمكن إبطال المفتاح دون إصدار مفتاح جديد. وسجل الاستخدام مقسّم إلى صفحات.

الصور والمستندات في الطلبات: أجزاء image_url على /v1/chat/completions، وكتل image وdocument وfile على /v1/messages، وأجزاء input_image على /v1/responses. الصور والملفات

نموذج جديد shannon-3-pro. النماذج والأسعار

نموذج جديد shannon-3. النماذج والأسعار

تحمل عمليات البث على /v1/chat/completions الاستدلال في delta.reasoning_content. جهد الاستدلال

تُبقى max_tokens بين 1 و65,536. القيمة الخارجة عن هذا النطاق تُقرَّب إلى أقرب طرف ولا تُرفض. Chat Completions

يُحتسب shannon-coder-1 بعدد الاستدعاءات لكل خطة على /v1/chat/completions و/v1/messages. عند استنفاد استدعاءات النافذة يكون الرد 429 مع الرسالة Shannon Coder call quota reached. أدوات البرمجة بسطر الأوامر

المحادثة الأكبر من نافذة السياق يُجاب عنها بـ 400 والنوع invalid_request_error والرمز context_length_exceeded. والخطأ داخل البث يصل كحدث خطأ، لا كنص في الإجابة. أدوات البرمجة بسطر الأوامر

نقاط نهاية /v1: POST /v1/chat/completions وPOST /v1/messages وPOST /v1/responses وGET /v1/models. وهي نقاط النهاية التي تستدعيها حزم OpenAI وAnthropic SDK وClaude Code وCodex CLI. نظرة عامة

استدعاءات الأدوات عبر tools على /v1/chat/completions و/v1/messages، والمخرجات المنظمة عبر response_format، وsystem كسلسلة نصية أو ككتل نص على /v1/messages. استدعاء الدوال

معرّفات النماذج shannon-1.6-pro وshannon-2-lite وshannon-2-pro وshannon-coder-1، إلى جانب shannon-1.6-lite. النماذج والأسعار

أول إصدار من API: الدردشة بصيغة OpenAI وبصيغة Anthropic، ونقطة نهاية Responses، تُستدعى كل منها بمفتاح API يبدأ بـ sk-. المصادقة