إرسال طلب GetAPI.ONE API

المتطلبات والحدود

• مفتاح GetAPI.ONE محدود النطاق محفوظ في GETAPI_ONE_API_KEY.
• نموذج حالي في الدليل يدرج صراحة نوع نقطة النهاية التي ستستدعيها.
• سطر أوامر يتوفر فيه curl ويسمح باتصالات HTTPS الصادرة إلى www.getapi.one.
• قبول احتمال فرض رسوم على طلب فعلي. روجعت الأمثلة دون إرسال طلبات للنماذج.

• إنشاء مفتاح وتحميله
• اختيار نموذج متوافق مع نقطة النهاية

1. اختيار نقطة النهاية المعلنة

تستخدم عائلات البروتوكولات الأخرى مسارات وأجسام طلبات مختلفة. اتبع نقطة نهاية صفحة النموذج، ولا توحّد استدعاءات Anthropic أو Gemini أو الصور أو الفيديو مع المثالين أعلاه.

2. مثال Responses API

استخدمه فقط بعد اختيار نموذج يدرج نقطة Responses. استبدل YOUR_RESPONSES_MODEL قبل التنفيذ.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. مثال Chat Completions

استخدمه فقط إذا أدرج النموذج المختار نقطة OpenAI Chat. استبدل YOUR_CHAT_MODEL قبل التنفيذ.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. فحص النتيجة

1. اقرأ حالة HTTP أولًا. تعني 2xx أن البوابة قبلت طلب HTTP وأكملته، لكن يجب فحص كائن الاستجابة بحثًا عن المخرج المتوقع.
2. في Responses افحص بنية status/output، وفي Chat Completions افحص choices. لا تفترض بنية استجابة واحدة للبروتوكولين.
3. افتح سجل طلبات أو استخدام GetAPI.ONE وطابق الوقت ونقطة النهاية والنموذج ومعرف الطلب عند توفره.

البث وإعادة المحاولة

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

• لا تُعد تلقائيًا محاولة أخطاء المصادقة أو الحصة أو الصلاحيات أو اختيار النموذج.
• قبل تكرار طلب انتهت مهلته أو فشل من المصدر الأعلى، حدد هل ربما عولج الطلب الأصلي وهل تكرار العملية آمن.
• استخدم عددًا محدودًا للمحاولات وانتظارًا متزايدًا في التطبيقات، واحفظ معرفات الطلبات والطوابع الزمنية للتشخيص.

مسارات معالجة الأخطاء

• قائمة استكشاف الأخطاء
• إعداد تقرير للدعم