دليل التكامل مع API

أكمل التكامل في ثلاث خطوات: التسجيل → الحصول على API Key → استدعاء أكثر من 400 نموذج كبير. توافق كامل مع OpenAI طوال العملية، ويمكنك تبديل النماذج دون تعديل الكود.

1سجّل حسابًا واحصل على API Key

  1. انتقل إلى صفحة التسجيل وسجّل برقم هاتفك أو بريدك الإلكتروني. تُفعَّل الخطة المجانية تلقائيًا عند التسجيل (مرة واحدة لكل جهاز/شبكة).
  2. أكمل التحقق من الاسم الحقيقي وفق إرشادات المنصة (للأفراد والمؤسسات على حد سواء) لضمان أمن الحساب وجودة الخدمة.
  3. بعد تسجيل الدخول، أنشئ API Key من صفحة «مفاتيح API» في لوحة تحكم المستخدم. لا يُعرض المفتاح إلا مرة واحدة عند إنشائه، فاحتفظ به جيدًا.
💡 تدعم المنصة أيضًا BYOK (Bring Your Own Key): اربط مفاتيح API Key الخاصة بمورّديك للإعفاء من رسوم المنصة، مع إدارة موحّدة للمفاتيح وإحصاءات الاستخدام والتحكم في الحدود.

2ضبط OpenAI SDK (Python)

واجهة APIGOTO متوافقة تمامًا مع OpenAI SDK، ويكفي تعديل base_url وapi_key:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.apigoto.com/v1",
    api_key="sk-your-api-key",
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

الاستدعاء باستخدام cURL

curl https://api.apigoto.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

3اختر نموذجًا وابدأ الاستدعاء

تدير المنصة بشكل موحّد أكثر من 400 نموذج رائد وأكثر من 70 مورّد نماذج. ما عليك سوى تذكّر اسم نموذج واحد على المنصة، وسيوجّهه النظام تلقائيًا إلى المورّد الأمثل ويحوّله تلقائيًا عند الأعطال:

قدرات النماذجالمورّدون المشمولونالاتفاقيات
محادثة نصيةClaude وGPT وGemini وDeepSeek وQwen وغيرهاOpenAI chat/completions、Anthropic messages
توليد الصورنماذج الرسم من سلسلة GPT وغيرهاOpenAI images
توليد الفيديونماذج الفيديو الرائدةنطاق التوافق مع OpenAI images
الصوتأبرز نماذج التعرف على الكلام وتركيبهبروتوكولات متوافقة مع OpenAI
⚡ التوجيه الذكي: تختار المنصة المسار تلقائيًا وفق «النموذج الدقيق → البروتوكول الدقيق → الأولوية المرتبطة → أولوية المورّد → درجة الصحة»، وتكون النماذج نفسها من عدة مورّدين نسخًا احتياطية لبعضها، مع تحويل تلقائي عبر 3 بيانات اعتماد كحد أقصى للطلب الواحد.
📌 اضبط model على اسم النموذج المعروض في صفحة "أسعار النماذج" (مثل claude-sonnet-5 وdeepseek-v4-pro)، ولا تضف بادئات المزوّد مثل anthropic/ أو openai/.

4توضيح الفوترة

  • طرق الفوترة: الدفع حسب الاستخدام (يُخصم الرصيد/Credits وفق استهلاك التوكنات الفعلي) أو خطة اشتراك. راجع صفحة "الاشتراك" في لوحة التحكم لتفاصيل الخطط.
  • أسعار شفافة: يمكنك الاستعلام الفوري عن السعر الرسمي وسعر المنصة لكل نموذج في صفحة أسعار النماذج، فتكون التكاليف واضحة تمامًا.
  • BYOK مجاني: الاستدعاء باستخدام مفاتيح المورّدين الخاصة بك لا يترتب عليه رسوم المنصة.
  • الرصيد/Credits: يدعم شحن الرصيد واستبدال Credits ، ويمكن الدفع عبر الإنترنت باستخدام Alipay.

الأسئلة الشائعة

كيف أبدّل بين النماذج بعد التكامل؟

يكفي تعديل حقل model في الطلب مباشرة دون أي تغيير في الكود. يقوم النظام تلقائيًا بمطابقة أسماء نماذج المنصة مع معرّفات النماذج الحقيقية لدى المورّدين الأصليين.

هل يدعم الإخراج المتدفق (Streaming)؟

نعم، مدعوم. أضف stream: true إلى الطلب لتفعيل الإرجاع المتدفق عبر SSE، بما يتوافق مع الاستخدام المتدفق في OpenAI SDK.

ماذا أفعل إذا فشل استدعاء API؟

يقوم النظام بالتحويل التلقائي عند الأعطال؛ وإذا استمر الفشل، يمكنك الإرسال عبر نموذج الملاحظات، وسنعالجه في أقرب وقت خلال أيام العمل.

أين أطلع على سجلات الاستدعاء والاستخدام؟

سجّل الدخول إلى لوحة التحكم وافتح "سجلات الاستدعاء" و"سجلات الاستهلاك" لعرض النموذج والتوكنات والتكلفة لكل استدعاء.