المستندات
يتوافق Unify API مع واجهة OpenAI API. إذا كانت شيفرتك تستدعي OpenAI بالفعل، فغيّر عنوان URL الأساسي والمفتاح — ويبقى كل شيء آخر كما هو.
البدء السريع
أنشئ حسابًا للحصول على مفتاح، ثم وجّه عميلك إلى https://api.unifyapi.ai/v1.
curl https://api.unifyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $UNIFYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5",
"messages": [{"role": "user", "content": "Hello"}]
}'استخدام حزمة SDK موجودة
يعمل أي عميل متوافق مع OpenAI. اضبط عنوان URL الأساسي ومفتاح Unify API الخاص بك:
from openai import OpenAI
client = OpenAI(
api_key=os.environ["UNIFYAPI_KEY"],
base_url="https://api.unifyapi.ai/v1",
)
response = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Hello"}],
)يمكن للعملاء المتوافقين مع أسلوب Anthropic استخدام /v1/messages بدلًا من ذلك، بالمفتاح نفسه.
المصادقة
مرّر مفتاحك كرمز Bearer في كل طلب. تُنشأ المفاتيح وتُلغى من وحدة التحكم، ويمكن قصر كل مفتاح على نماذج محددة وتعيين حد إنفاق خاص به.
Authorization: Bearer sk-...نقاط النهاية
| POST /v1/chat/completions | محادثة متوافقة مع OpenAI |
| POST /v1/messages | رسائل متوافقة مع Anthropic |
| POST /v1/responses | OpenAI Responses API |
| POST /v1/embeddings | تضمينات النصوص |
| POST /v1/images/generations | توليد الصور |
| GET /v1/models | عرض النماذج المتاحة لمفتاحك |
استدعِ GET /v1/models لمعرفة النماذج التي يمكن لمفتاحك الوصول إليها بدقة — هذه القائمة هي المرجع المعتمد لحسابك.
اختيار نموذج
مرّر أي نموذج يملك مفتاحك صلاحية الوصول إليه في الحقل model. يوجّه Unify API الطلب إلى المزوّد الذي يقف خلفه، ويحوّله تلقائيًا إذا تراجع أداء ذلك المزوّد، لذا يستمر اسم النموذج الواحد في العمل حتى أثناء أي عطل لدى المزوّد.
الأخطاء
تتبع الأخطاء بنية أخطاء OpenAI، لذا تستمر معالجة الأخطاء الحالية لديك في العمل. يعني 401 أن المفتاح مفقود أو ملغى، ويعني 429 أنك بلغت حد المعدل أو حد الإنفاق — ويظهر كلاهما في وحدة التحكم.