تكامل SDK

يمكن استخدام SDK متوافق مع OpenAI لاستدعاء واجهات النص التي يدعمها فعلًا. أضف /v1 إلى أصل API لتكوين base_url الخاص بـ SDK؛ فالأصل نفسه لا يحتوي على إصدار. يظل النموذج مستخدمًا بمعرّفه العام من كتالوج Key الحالي.

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GLOOP_API_KEY"],
    base_url=os.environ["GLOOP_API_BASE"].rstrip("/") + "/v1",
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["GLOOP_MODEL"],
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.GLOOP_API_KEY,
  baseURL: process.env.GLOOP_API_BASE.replace(/\/$/, '') + '/v1',
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: process.env.GLOOP_MODEL,
  messages: [{ role: 'user', content: '你好' }],
});
console.log(response.choices[0].message.content);

تعطّل الأمثلة المحاولات التلقائية لتجنب إعادة طلب مدفوع دون تأكيد عند انقطاع الشبكة. يتحدد تفعيل الإعادة وفق عقد عدم التكرار للواجهة المحددة؛ ولا تفترض أن المنصة تزيل التكرار لجميع استدعاءات SDK.

واجهات المنصة الخاصة

استخدم عميل HTTP عاديًا لعروض الصور والمهام الدائمة والأدوات والملفات. لا تستدعِ أساليب SDK غير موجودة مثل client.image_tasks.create. تقدم صفحات نقاط النهاية أمثلة cURL وrequests وfetch، مع التمييز بين JSON وmultipart وSSE والبيانات الثنائية.

احفظ استجابات الصوت كبايتات؛ ودع العميل ينشئ boundary لـ multipart عند رفع الصور؛ وحلّل البث حدثًا بحدث. لا ترسل حقول API المخصصة إلا إذا صرّحت نقطة النهاية بدعمها. توافق SDK لا يعني توفر كل ميزات OpenAI. اقرأ أولًا دليل البث والاستعادة غير المتزامنة.