ربط GetAPI.ONE باستخدام Python: حزمة OpenAI SDK وواجهة Responses

ابدأ من هنا

يرسل مثال Python هذا طلبًا نصيًا عبر نقطة النهاية Responses. تحتاج إلى مفتاح API من GetAPI.ONE ونموذج يذكر صراحةً دعمه لهذه النقطة. احتفظ بالمفتاح في بيئة العملية؛ لا ينطبق المثال على جميع نماذج الصور أو الفيديو.

• إنشاء حساب
• إنشاء مفتاح API
• تسميات نقاط النماذج

تجهيز المشروع والاعتماد

• Python 3.10 أو أحدث وبيئة افتراضية.
• مفتاح GetAPI.ONE مفعّل بصلاحية وحصة مقصودتين.
• معرف نموذج من الدليل الحالي يعلن نقطة Responses.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

الإعداد وإرسال الطلب

1. اضبط GETAPI_ONE_API_KEY في بيئة العملية ولا تلصق المفتاح في الملف.
2. أنشئ العميل بعنوان https://www.getapi.one/v1 في base_url.
3. استبدل اسم النموذج النائب الواضح بمعرف حالي دقيق يعلن Responses.
4. شغّل النص فقط إذا قبلت احتمال فوترة الطلب.
5. يعطّل التحقق الأول محاولات SDK. أضف تكرارًا محدودًا قابلًا للملاحظة فقط بعد تحديد العمليات الآمنة للتكرار.

import os
from openai import OpenAI

api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
    raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")

with OpenAI(
    api_key=api_key,
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.responses.create(
        model="<MODEL_ID_FROM_CURRENT_CATALOG>",
        input="Reply with one short readiness check.",
    )
    print(response.output_text)

فهم العقد

التحقق من النتيجة المتوقعة

• تنتهي العملية دون خطأ مصادقة أو نقطة نهاية.
• يحتوي response.output_text على الجواب القصير المطلوب.
• تعرض وحدة GetAPI.ONE سجل طلب أو استخدام مطابقًا للمفتاح.

إصلاح الأخطاء الشائعة

إبقاء التكامل آمنًا

• شغّل SDK في أدوات محلية أو خادم موثوق فقط، وليس في JavaScript المتصفح.
• استبعد ملفات .env من إدارة الإصدارات ودوّر المفتاح فورًا إذا انكشف.
• استخدم مفاتيح محدودة منفصلة للتطوير والإنتاج.

الخطوات التالية

• بث استجابةعالج أحداث دورة SSE والنتائج النهائية.
• اختيار نموذجطابق المهمة مع عقد نقطة الدليل.