دليل التكامل مع 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="anthropic/claude-sonnet-4",
    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/deepseek-chat",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

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

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

قدرات النماذجالمورّدون المشمولونالاتفاقيات
محادثة نصيةClaude وGPT وGemini وDeepSeek وQwen وغيرهاOpenAI chat/completions、Anthropic messages
توليد الصورنماذج الرسم من سلسلة GPT وغيرهاOpenAI images
توليد الفيديونماذج الفيديو الرائدةنطاق التوافق مع OpenAI images
تضمينات متجهية / صوتنماذج التضمين والصوت الرائدةOpenAI embeddings / بروتوكولات متوافقة
⚡ التوجيه الذكي: تختار المنصة المسار تلقائيًا وفق «النموذج الدقيق → البروتوكول الدقيق → الأولوية المرتبطة → أولوية المورّد → درجة الصحة»، وتكون النماذج نفسها من عدة مورّدين نسخًا احتياطية لبعضها، مع تحويل تلقائي عبر 3 بيانات اعتماد كحد أقصى للطلب الواحد.

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

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

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

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

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

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

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

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

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

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

سجّل الدخول إلى لوحة تحكم المستخدم واطلع على نموذج كل استدعاء وتوكناته وتفاصيل تكلفته في «سجلات الاستدعاء» و«إحصاءات الاستخدام».