بطاقة PCIe من تصميمنا، تعمل ببرنامج ثابت طوّرته Sigmix — تنقية وتدقيق داخل شريحة مخصّصة.
اكتشف Sigmix Guard
كل طلب يُنفَّذ داخل الجهاز نفسه، بمعزل عن الإنترنت.
اطّلع على وضعك الأمنيكل ما هنا ينطبق على المسارين. ولكل مسار صفحته بنماذجه وأسعاره وأمثلته.
https://inference.sigmix.sa/ksa-sovereign-route-only/v1أرسل المفتاح في الترويسة Authorization: Bearer متبوعة بالمفتاح. ويُقبل x-api-key أيضاً للمكتبات التي ترسله.
تبدأ المفاتيح السيادية بـ sgx-ksa- والدولية بـ sgx-intl-. يُرفض المفتاح على مسار الآخر بالرمز wrong_route.
نحتفظ ببصمة لكل مفتاح لا بالمفتاح نفسه. ويسري الإلغاء من الطلب التالي.
Authorization: Bearer sgx-ksa-… # sovereign key Authorization: Bearer sgx-intl-… # international key
تتبع صيغ الطلبات والاستجابات صيغ OpenAI، فتعمل المكتبات الرسمية بتغيير base_url وapi_key.
chat/completions وembeddings وaudio/speech وaudio/transcriptions وaudio/translations وimages/generations، وGET models.
x-request-id في كل استجابة؛ وx-sigmix-route؛ وx-sigmix-charge-usd بالمبلغ الدقيق في الاستجابات غير المتدفقة (ويظهر مبلغ البث في صفحة الاستهلاك)؛ وx-sigmix-max-tokens-clamped عندما يتجاوز max_tokens حد النموذج.
استخدم المعرّف من قائمة نماذج المسار أو GET <base>/models. قد يوجد المعرّف نفسه على المسارين بوصفهما نموذجين منفصلين بسعرين.
واجهتا Responses وAssistants، ورفع الملفات، والضبط الدقيق. تعمل روابط الصور في المحادثة حيث يجلبها النموذج؛ وتقبل بعض النماذج الدولية روابط base64 فقط.
temperature وtop_p وn وstop وseed وfrequency_penalty وpresence_penalty وlogit_bias وlogprobs وtop_logprobs وresponse_format وtools (أدوات الدوال فقط) وtool_choice وparallel_tool_calls وstream_options؛ وreasoning_effort وreasoning_format وinclude_reasoning في النماذج التي تستدل. تُقبل user وmetadata وstore وservice_tier ولا تُمرَّر. أي معامل آخر، أو معامل لا يستطيع النموذج الالتزام به، يُرفض بالرمز invalid_request مع ذكر اسمه — ولا يُتجاهل بصمت. قيمة seed على أفضل وجه ممكن. معرّفات استدعاءات الأدوات نُصدرها نحن بصيغة call_.
stream: true في المحادثة يُرجع أحداثاً متدفقة بصيغة OpenAI وتنتهي بـ data: [DONE].
max_tokens — قبل أول وحدة. ويُرسل max_tokens إلى النموذج دائماً فيبقى السقف قائماً.stream_options.include_usage لتستلم جزء الاستخدام؛ والفوترة تستند إليه في الحالتين.تتبع الأخطاء صيغة OpenAI مع رمز يوضح من المسؤول. ولا يُحتسب أي طلب فشل.
{
"error": {
"message": "Your available balance does not cover this request…",
"type": "insufficient_quota",
"code": "insufficient_credit",
"param": null,
"request_id": "6f0c…"
}
}| HTTP | الرمز | المسؤول | المعنى | ما العمل |
|---|---|---|---|---|
401 | invalid_api_key | من جهتك | المفتاح مفقود أو بصيغة خاطئة أو غير معروف أو ملغى. | أرسل Authorization: Bearer مع مفتاح صالح من لوحة التحكم. |
403 | wrong_route | من جهتك | المفتاح يخص المسار الآخر. | استخدم المفتاح على مساره، أو أنشئ مفتاحاً لهذا المسار. |
403 | account_suspended | من جهتك | الحساب معلّق أو مغلق. | |
400 | invalid_request | من جهتك | جسم الطلب غير صحيح أو أحد الحقول غير صالح. | راجع error.param وerror.message. |
404 | unknown_endpoint | من جهتك | لا توجد نقطة وصول بهذا العنوان. | طابق العنوان مع جدول نقاط الوصول في صفحة المسار. |
404 | model_not_found | من جهتك | هذا النموذج غير منشور على هذا المسار. | يعرض GET <base>/models المتاح. |
403 | model_not_allowed | من جهتك | المفتاح مقصور على نماذج أخرى. | عدّل النماذج المسموح بها للمفتاح. |
400 | modality_mismatch | من جهتك | يُستدعى النموذج على نقطة وصول أخرى. | استخدم نقطة الوصول المذكورة في الرسالة. |
413 | payload_too_large | من جهتك | الجسم يتجاوز 16 MB أو الملف الصوتي يتجاوز 25 MB. | أرسل أقل، أو قسّم الملف الصوتي. |
400 | context_length_exceeded | من جهتك | الرسائل أطول بكثير مما تتسع له نافذة سياق النموذج. يُرفض الطلب قبل أي حجز أو إرسال، ولا يُخصم شيء. | اختصر المحادثة، أو استخدم نموذجاً بنافذة سياق أكبر. |
402 | insufficient_credit | من جهتك | رصيدك المتاح لا يغطي أقصى تكلفة ممكنة لهذا الطلب. | أضف رصيداً، أو قلّل max_tokens. |
402 | paid_credit_required | من جهتك | لا يمكن الدفع لهذا النموذج برصيد التجربة المجانية، ورصيدك المدفوع لا يغطي أقصى تكلفة ممكنة للطلب. | اشحن رصيدك، أو استخدم نموذجاً مشمولاً في التجربة المجانية. |
403 | streaming_not_allowed | من جهتك | البث معطّل لهذا المفتاح أو الحساب، أو الرصيد دون الحد الأدنى. | أرسل بدون stream: true، أو أضف رصيداً. |
429 | rate_limited | من جهتك | طلبات كثيرة هذه الدقيقة لهذا المفتاح. | انتظر عدد الثواني في Retry-After. |
429 | concurrency_limit | من جهتك | طلبات متزامنة كثيرة لهذا المفتاح، أو أكثر من أربعة طلبات يتجاوز كل منها 1 MB ما زالت قيد الرفع في الوقت نفسه من حسابك. | انتظر انتهاء أحدها، أو ارفع حد المفتاح. |
429 | spend_cap_reached | من جهتك | بلغت سقفاً يومياً أو شهرياً أو للطلب الواحد حددته بنفسك. | ارفع السقف على المفتاح، أو انتظر الفترة التالية. |
503 | gateway_disabled | متوقف | أوقف المشغّل الواجهة مؤقتاً. | أعد المحاولة بعد Retry-After؛ راجع صفحة الحالة. |
503 | route_disabled | متوقف | أوقف المشغّل هذا المسار مؤقتاً. | أعد المحاولة لاحقاً. لا يُنقل الطلب السيادي إلى المسار الآخر. |
503 | modality_disabled | متوقف | أوقف المشغّل نقطة الوصول هذه مؤقتاً. | أعد المحاولة لاحقاً. |
503 | model_disabled | متوقف | أوقف المشغّل هذا النموذج مؤقتاً. | أعد المحاولة لاحقاً، أو استخدم نموذجاً آخر. |
503 | capacity_exhausted | من جهتنا | كل نقاط الخدمة لهذا النموذج مشغولة، أو أن الخدمة تستقبل طلبات كبيرة كثيرة في الوقت نفسه. | أعد المحاولة بعد لحظة. |
503 | upstream_unavailable | من جهتنا | لا توجد نقطة على هذا المسار تخدم النموذج الآن. | أعد المحاولة؛ راجع صفحة الحالة. |
504 | upstream_timeout | من جهتنا | لم يُجب النموذج في الوقت المحدد. | أعد المحاولة، أو قلّل max_tokens. |
502 | upstream_error | من جهتنا | أخفقت نقطة النموذج. | أعد المحاولة. لا يُحتسب. |
400 | upstream_rejected | من جهتك | رفض النموذج الطلب — طويل جداً أو قيمة لا يقبلها. يُذكر السبب بصياغتنا، مع اسم المعامل إن وُجد. | اقرأ الرسالة؛ اختصر الطلب أو عدّله. |
504 | deadline_exceeded | من جهتك | بلغ الطلب حدّه الأقصى (15 دقيقة). تتوقف الإجابة المتدفقة عنده ولا يُحتسب إلا ما وُلّد منها، والطلب الذي لم تبدأ إجابته لا يُحتسب. | قلّل max_tokens، أو قسّم العمل. |
503 | service_restarting | من جهتنا | كانت الواجهة تُعاد تشغيلها. تتوقف الإجابة المتدفقة الجارية ولا يُحتسب إلا ما وُلّد منها، والطلب الذي لم يبدأ لا يُحتسب. | أعد المحاولة بعد Retry-After. |
500 | internal_error | من جهتنا | حدث عطل من جهتنا. | أعد المحاولة واذكر request_id إن تكرر. لا يُحتسب. |
الطلبات في الدقيقة لكل مفتاح: الحد الافتراضي ما لم تحدد غيره على المفتاح. تجاوزه يُرجع 429 مع Retry-After.
أجسام JSON حتى 16 MB؛ والصوت حتى 25 MB؛ وحتى 8 خيارات (n) لطلب المحادثة و10 صور لطلب الصور.
إن أخفقت نقطة قبل الإجابة تعيد البوابة المحاولة على نقطة أخرى في المسار نفسه. أعد المحاولة بنفسك عند 429 و503 و504، لا عند أخطاء 4xx.
لكل طلب: الوقت، والمفتاح، والنموذج والمسار، وأعداد الوحدات أو الأحرف أو الثواني أو الصور، والمبلغ، وزمن الاستجابة، والنتيجة. ولا نحتفظ أبداً بالنص أو الإجابة أو الصوت أو الصورة.
على المسار الدولي تعالج الخدمة التي تُجيب الطلبَ وفق شروطها.
أنشئ حساباً، وأصدر مفتاحاً للمسار الذي تحتاجه، والصق مثالاً من صفحته.