---
title: "ما هي واجهة API المتوافقة مع OpenAI؟ وكيف تعمل؟ | BroadRouter"
description: "واجهة API المتوافقة مع OpenAI تقبل طلبات OpenAI نفسها، فتعمل حزم SDK الحالية بتغيير العنوان الأساسي والمفتاح والنموذج. ما الذي يتطابق، وما الذي يختلف، ولماذا."
url: https://broadrouter.com/ar/glossary/openai-compatible-api/
lang: ar
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/glossary/openai-compatible-api/) (حُدّث في 2026-11-15).

# واجهة API متوافقة مع OpenAI (OpenAI-compatible API)

آخر تحديث 2026-11-15

واجهة API المتوافقة مع OpenAI هي واجهة HTTP تقبل صيغ الطلبات والاستجابات نفسها التي تستخدمها OpenAI API، مثل POST /v1/chat/completions، فتستطيع حزم OpenAI SDK وأدواتها استخدامها بتغيير العنوان الأساسي (base URL) ومفتاح API واسم النموذج فقط.

يُسمّى أيضًا: واجهة متوافقة مع OpenAI، API متوافق مع OpenAI، بديل مباشر لـ OpenAI، OpenAI-compatible API، OpenAI API compatible، OpenAI-style API، OpenAI drop-in replacement

أصبحت صيغة OpenAI API اللغة المشتركة لأدوات نماذج اللغة الكبيرة. يقبلها اليوم كثير من المزوّدين، فتستطيع مكتبة عميل واحدة التخاطب مع خوادم كثيرة.

## كيف تعمل

تنسخ الواجهة المتوافقة أجزاء OpenAI API التي يعتمد عليها العملاء:

-   المسارات نفسها، مثل `/v1/chat/completions` و`/v1/audio/transcriptions`؛
-   صيغ JSON نفسها: مصفوفة `messages` في الطلب، و`choices[0].message.content` في الرد، وكتلة `usage` بأعداد الرموز؛
-   [مفتاح API](https://broadrouter.com/ar/glossary/api-key/) يُرسل بالصيغة `Authorization: Bearer <key>`؛
-   [البث المتدفق](https://broadrouter.com/ar/glossary/streaming/) بأحداث server-sent events حين تكون قيمة `stream` هي true.

التبديل مجرد تغيير في الإعدادات. مع حزمة Python SDK الرسمية:

```python
from openai import OpenAI
import os

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
reply = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in Arabic."}],
)
print(reply.choices[0].message.content)
```

تغيّرت ثلاث قيم فقط عن مثال OpenAI: [العنوان الأساسي](https://broadrouter.com/ar/glossary/base-url/)، والمفتاح، ومعرّف النموذج.

## لماذا تهم

يخفّض التوافق كلفة التبديل. فحزم SDK وأطر الوكلاء وإضافات بيئات التطوير و[الموجّهات (routers)](https://broadrouter.com/ar/glossary/llm-router/) التي تتحدث بصيغة OpenAI تعمل دون شيفرة جديدة. يمكنك اختبار مزوّد ثانٍ في دقائق والاحتفاظ بخيار الانتقال.

لكن المتوافق ليس مطابقًا. فطبقة التوافق لدى Anthropic نفسها، مثلًا، تتجاهل `strict` في الأدوات وتترك `prompt_tokens_details` فارغًا. ومن الفجوات المعتادة:

-   معاملات تُتجاهل أو تُرفض؛
-   طريقة احتساب [رموز الاستدلال المنطقي](https://broadrouter.com/ar/glossary/reasoning-tokens/) ضمن `max_tokens`؛
-   هل يُبلَّغ عن الاستهلاك في نهاية البث أم لا؛
-   حدود المعدل ورموز الأخطاء.

## في BroadNet Inference

يقدّم BroadNet Inference `POST /v1/chat/completions` و`POST /v1/audio/transcriptions` و`GET /v1/models` على `https://inference.broadnet.ai/v1`. ولا تُرسل المفاتيح إلا بالصيغة `Authorization: Bearer <key>`. يعرض دليلا [Python](https://broadrouter.com/ar/guides/openai-python-sdk/) و[Node](https://broadrouter.com/ar/guides/openai-node-sdk/) الإعداد الكامل، ويعمل [LangChain](https://broadrouter.com/ar/guides/langchain-openai-base-url/) بالطريقة نفسها.

خطّط لفرقين: تُجري نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B استدلالًا منطقيًا قبل الإجابة، ويُحتسب الاستدلال ضمن `max_tokens`. كما يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات في آنٍ واحد. وتغطي [قائمة التحقق للانتقال](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/) بقية النقاط.

## أخطاء شائعة

-   الإبقاء على اسم نموذج من OpenAI مثل `gpt-6-astra` (النموذج الرائد لدى OpenAI على صفحة النماذج لديها، تاريخ المراجعة 2026-11-15). استخدم معرّف النموذج لدى المزوّد.
-   افتراض أن معاملًا يعمل لأن الطلب نجح. بعض المزوّدين يتجاهلون الحقول غير المعروفة بصمت.

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

### هل يعني التوافق مع OpenAI أن كل ميزات OpenAI تعمل؟

لا. يعني أن الصيغ الأساسية للطلبات والاستجابات متطابقة. وقد تُتجاهل حقول بعينها أو تُرفض. فطبقة التوافق لدى Anthropic مثلًا توثّق حقولًا تتجاهلها وأخرى تُرجع خطأ 400. اقرأ قائمة المزوّد قبل أن تعتمد على أي معامل.

### هل أحتاج إلى حزمة SDK مختلفة؟

لا. تقبل حزم OpenAI SDK الرسمية عنوانًا أساسيًا مخصّصًا. مرّر base\_url في Python، أو baseURL في Node، أو اضبط متغير البيئة OPENAI\_BASE\_URL.

### ما نقاط النهاية التي يدعمها BroadNet Inference؟

POST /v1/chat/completions للمحادثة، وPOST /v1/audio/transcriptions لتحويل الكلام إلى نص. وتوجد أيضًا GET /v1/models، لكن وثائق BroadNet تصفها بأنها بيانات وصفية عامة للكتالوج مخصّصة لأدوات المراقبة الخارجية، لذا خذ معرّفات النماذج لطلباتك من مرجع API.

## انظر أيضًا

-   [العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/) (مصطلح)
-   [مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/) (مصطلح)
-   [موجّه LLM (LLM router)](https://broadrouter.com/ar/glossary/llm-router/) (مصطلح)
-   [البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/) (مصطلح)
-   [مزوّد الاستدلال (Inference provider)](https://broadrouter.com/ar/glossary/inference-provider/) (مصطلح)
-   [الأحداث التي يرسلها الخادم (SSE)](https://broadrouter.com/ar/glossary/sse/) (مصطلح)
-   [Chat Completions API (واجهة إكمال المحادثة)](https://broadrouter.com/ar/glossary/chat-completions-api/) (مصطلح)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [استخدام OpenAI Node.js SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-node-sdk/) (دليل)
-   [استخدام LangChain مع BroadNet Inference](https://broadrouter.com/ar/guides/langchain-openai-base-url/) (دليل)
-   [أول طلب إلى BroadNet Inference باستخدام curl](https://broadrouter.com/ar/guides/curl-quickstart/) (دليل)
-   [الانتقال إلى واجهة API متوافقة مع OpenAI: قائمة تحقق للترحيل](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/) (مقال)
-   [OpenRouter أم خطة بسعر ثابت لوكلاء الذكاء الاصطناعي: أيهما أرخص؟](https://broadrouter.com/ar/blog/openrouter-alternative-flat-rate/) (مقال)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-openai-compatible-api&utm_content=page-cta) ·

**المصادر**

-   [المرجع التقني لـ OpenAI API، إنشاء إكمال محادثة](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Anthropic، التوافق مع OpenAI SDK وحدوده](https://platform.claude.com/docs/en/api/openai-sdk)
-   [OpenAI Python SDK (base\_url وOPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-openai-compatible-api&utm_content=sources)
-   [OpenAI، النماذج (تاريخ المراجعة 2026-11-15)](https://developers.openai.com/api/docs/models)
