يتبع API من Sigmix صيغ الطلبات والاستجابات التي يكتب لها فريقك اليوم، فمعظم عمليات التكامل لا تحتاج أكثر من تغيير عنوان القاعدة (base URL). ما يختلف هو وجهة الاستدعاء: جهازك المحكم داخل مقرّك، أو سحابة داخل المملكة لا تغادر بياناتك حدود السعودية.

البدء السريع نقاط النهاية

// مفاتيح ذاتية الإصدار من لوحة التحكم · الواجهة نفسها في كل أنماط النشر

curl

# the only thing that changes between postures is the base URL
curl https://api.sigmix.ai/v1/chat/completions \
  -H "Authorization: Bearer $SIGMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sigmix-chat-standard",
    "messages": [
      {"role": "user", "content": "لخّص هذا التقرير"}
    ]
  }'

مصمّم لمنظومتك التقنية

مفاتيح API ذاتية الإصدار واجهة واحدة في كل أنماط النشر العربية والإنجليزية دعم البث التدفقي موثّق بمراسي التدقيق افتراضياً

البدء السريع

وجّهه إلى نمط النشر الذي اشتريته.

واجهة API واحدة عبر كل بيئات النشر. لا تتغيّر شيفرتك حين تنتقل من تجربة سحابية إلى جهاز محكم داخل مقرّك — يتغيّر عنوان القاعدة فقط، وهذه هي عملية الترحيل بكاملها.

سحابة داخل المملكة

السحابة السعودية

https://api.sigmix.ai/v1

مناطق Oracle داخل المملكة. مرنة ومُدارة، ولا شيء يعبر الحدود.

خزانة خوادمك

جهاز داخل مقرّك

https://sigmix.internal/v1

يُحلّ اسمه داخل شبكتك وحدها، ولا وجود أصلاً لمسار صادر يخرج منها.

على المكتب

Sigmix Zero

http://localhost:8443/v1

يقدّم الجهاز نقطة نهايته الخاصة عبر الواجهة المحلية (loopback). ويعمل حتى والشبكة مفصولة.

اختياري · خارج المملكة

السحابة العالمية

https://api.sigmix.ai/v1

المستوى الوحيد الذي يصل إلى النماذج الرائدة — والوحيد غير السيادي. ومُعلَّم بذلك في كل موضع.

المصادقة

مفاتيح Bearer محدّدة النطاق وقابلة للإبطال.

أنشئ مفاتيحك بنفسك من لوحة التحكم — بلا تذكرة دعم ولا مكالمة مبيعات. كل مفتاح محدّد بنطاق مشروع، وله حدّ معدّل خاص به، ويمكن تدويره أو إبطاله دون المساس بالبقية. وكل استدعاء يجريه يُنسب إليه في سجل التدقيق.

يُعرض المفتاح مرة واحدة عند إنشائه ويُخزَّن مجزّأً (hash). وإذا فُقد مفتاح فإنه يُدوَّر لا يُستعاد — وهو السلوك الذي يتوقعه فريق الأمن لديك.

python

import os
from sigmix import Sigmix

client = Sigmix(
    api_key=os.environ["SIGMIX_API_KEY"],
    # swap this one line to move posture
    base_url="https://sigmix.internal/v1",
)

resp = client.chat.completions.create(
    model="sigmix-chat-standard",
    messages=[{"role": "user", "content": "Summarise Q3 revenue"}],
    stream=True,
)

for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

المرجع

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

الواجهة الأساسية. يختلف التوفّر باختلاف نمط النشر — فالجهاز المحكم يصل إلى مستويات نماذج أدنى من خزانة GPU، وتُبلغ الواجهة عمّا تستطيع تقديمه فعلياً.

الطريقة	المسار	الوظيفة
POST	`/v1/chat/completions`	محادثة وإكمال، بالبث التدفقي أو دفعة واحدة. بالعربية والإنجليزية.
POST	`/v1/embeddings`	تضمينات متجهية لمسارات الاسترجاع الخاصة بك.
POST	`/v1/documents`	إدخال مستند إلى قاعدة معرفية. ويُنقّي Guard البيانات الشخصية قبل الفهرسة.
POST	`/v1/documents/query`	استعلام معزّز بالاسترجاع على قاعدة معرفية مفهرسة.
POST	`/v1/images/generations`	توليد الصور، حيثما توفّرت لنمط النشر قدرة الحوسبة اللازمة.
POST	`/v1/audio/transcriptions`	تحويل الكلام إلى نص، بالعربية والإنجليزية.
GET	`/v1/models`	ما تستطيع بيئة النشر هذه تقديمه فعلياً — لا كتالوج عالمي.
GET	`/v1/audit/anchors`	جلب مراسي تدقيق موقّعة بـ TPM للتحقق المستقل.
GET	`/v1/health`	حالة التشغيل وجاهزية النماذج — وعلى أنماط النشر المحكمة، عدّاد خروج البيانات.

// المرجع الكامل والمخططات ورموز الأخطاء في وثائق المطوّرين — الرابط في لوحة التحكم بمجرد حصولك على مفتاح

ما لا يمنحك إياه API عادي للذكاء الاصطناعي

الجوانب السيادية.

مراسي تدقيق قابلة للتحقق

كل استدعاء يُجزّأ داخل مرساة متسلسلة ويُوقَّع بـ TPM. اسحبها من /v1/audit/anchors وتحقّق منها بنفسك خارج الجهاز.

التنقية على مسار الطلب

تُحجب أنماط الهوية الوطنية والإقامة وأرقام IBAN والبطاقات قبل أن يراها النموذج — عبر API أيضاً، لا في التطبيق وحده.

إقامة البيانات في الاستجابة

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

قائمة نماذج صادقة

/v1/models يُعيد ما تستطيع بيئة النشر هذه تقديمه. ولن يُعلن جهاز محكم الإغلاق عن نموذج رائد لا يستطيع تشغيله.

لا تدريب على استدعاءاتك

لا تُستخدم حركة API لتدريب أي نموذج على الإطلاق. وعلى أنماط النشر المحكمة يسقط السؤال من أساسه — فلا شيء يغادر ليُدرَّب عليه.

قابل للنقل بحكم التصميم

لا صيغة نقل احتكارية ولا ارتهان لمزوّد. وإن تجاوزتنا يوماً، فلا يفصل تكاملك عن بديل آخر سوى تغيير عنوان القاعدة.

مكتبات العميل

استخدم مكتبتنا، أو التي بين يديك أصلاً.

لأن الواجهة متوافقة، تعمل معظم المكتبات التي تستخدمها اليوم بمجرد توجيهها إلى عنوان قاعدة Sigmix. ونوفّر أيضاً SDK من تطويرنا حيثما يوفّر عليك الشيفرة المتكررة.

PyPythonpip install sigmix

JSNode / TypeScriptnpm i @sigmix/sdk

C#.NETdotnet add package Sigmix

GoGogo get sigmix.sa/go

{ }RESTأي عميل HTTP

حدود المعدّل

محكومة بباقتك، أو بعتادك.

على السحابة، تُحسب الحدود لكل مفتاح ولكل باقة. أما على الجهاز فأنت تملك قدرة الحوسبة، والسقف الوحيد هو الجهاز نفسه — فنحن لا نضع عدّاداً على ما تملكه أصلاً.

نمط النشرحدّ الطلباتملاحظات

السحابة السعودية · القياسية60 طلباً / دقيقة / مفتاحيُسمح بدفعات فوق المعدّل الثابت؛ ويُعاد 429 مع Retry-After.

السحابة السعودية · المخصّصةحسب العقدسعة GPU مخصّصة داخل المملكة للجهات الخاضعة للتنظيم.

جهاز داخل مقرّكبلا عدّادمحكوم بعتادك أنت. ولا نفرض حدود معدّل على جهاز تملكه.

Sigmix Zeroبلا عدّادواجهة محلية (loopback). والإنتاجية هي ما يحتمله الجهاز.

أسئلة

للمطوّرين

ما مدى "التوافق" حقاً؟

واجهات المحادثة والتضمينات والنماذج الأساسية تتبع الصيغ التي تكتب عليها معظم الفرق بالفعل، لذا تعمل مكتبات العملاء الحالية عادةً بتغيير عنوان القاعدة فقط. أما نقاط النهاية السيادية — مراسي التدقيق، وترويسات إقامة البيانات، وإدخال المستندات مع التنقية — فهي إضافات لا بدائل، فلا ينكسر شيء إن تجاهلتها.

هل أحتاج مفتاحاً مختلفاً لكل نمط نشر؟

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

هل يعمل API بدون إنترنت؟

على الجهاز وعلى Sigmix Zero، نعم — فنقطة النهاية داخل شبكتك أو على الواجهة المحلية. وهذا هو مغزى هذين النمطين: الواجهة محلية، فتستمر في العمل حين تتوقف الشبكة.

أي النماذج يمكنني طلبها؟

استدعِ /v1/models على بيئة النشر التي تشير إليها. فهي تُعيد ما يستطيع ذلك الجهاز أو تلك المنطقة تقديمه فعلياً بدل كتالوج عالمي، فلا يقع لديك إخفاق أثناء التشغيل بسبب طلب شيء لا يستطيع العتاد تشغيله.

هل تُستخدم حركة API في التدريب؟

لا — لا من جانبنا ولا من جانب أي مزوّد خلفنا. لا يوجد مجمّع تدريب مشترك. وعلى أنماط النشر المحكمة لا يغادر شيء المبنى أصلاً حتى يكون ذلك ممكناً.

كيف أتحقق من مرساة تدقيق؟

اسحب المرساة من /v1/audit/anchors، وتحقّق من السلسلة، ثم من توقيع TPM مقابل المفتاح العام للجهاز. والمواصفة موجودة في حزمة الأدلة — راجع مركز الثقة.

ابدأ البناء

احصل على مفتاح وأجرِ استدعاءً واحداً.

ابدأ على السحابة السعودية خلال التجربة، واكتب تكاملك عليها، ثم أعد توجيه عنوان القاعدة حين يُركَّب جهازك في الخزانة. الشيفرة نفسها، مبنى مختلف.

جرّب Workspace مجاناً مركز الثقة تحدّث إلينا

تصل إشعارات حالة الخدمة والحوادث إلى مسؤول الحساب التقني لديك.