---
title: البدء السريع | RunAPI
description: استدع نماذج اللغة في RunAPI عبر بروتوكول متزامن أو دفقي مدعوم.
url: https://runapi.ai/ar/docs/guides/llm-api/quickstart.md
canonical: https://runapi.ai/ar/docs/guides/llm-api/quickstart
locale: ar
---

> نسخة HTML: https://runapi.ai/ar/docs/guides/llm-api/quickstart
> فهرس الموقع للوكلاء: https://runapi.ai/llms.txt

# البدء السريع

يعرض RunAPI نماذج اللغة من خلال أشكال البروتوكول العامة المألوفة.
وجِّه عميلاً متوافقاً موجوداً إلى `https://runapi.ai`، واستخدم
معرّف نموذج RunAPI، وتحقَّق بمفتاح API قياسي.

## اختر بروتوكولاً

* يستخدم Chat Completions المتوافق مع OpenAI المسار `POST /v1/chat/completions`.
* يستخدم Responses المتوافق مع OpenAI المسار `POST /v1/responses`.
* يستخدم Messages المتوافق مع Anthropic المسار `POST /v1/messages`.
* يستخدم توليد المحتوى المتوافق مع Gemini المسار `/v1beta/models/{model}:generateContent` أو `:streamGenerateContent`.

اختر البروتوكول الذي يتوافق بشكل أفضل مع عميلك الحالي وتدفق
تطبيقك. يُحدّد كتالوج النماذج البروتوكولات العامة التي يدعمها كل نموذج.

## إرسال طلب

يُعيد طلب Chat Completions هذا استجابة متزامنة واحدة:

```shell
curl "https://runapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Summarize why idempotency matters."}]
  }'
```

احتفظ بشكل البروتوكول المحدد للطلب والاستجابة. استخدم مرجع API للعملية للاطلاع على الحقول الدقيقة واستدعاء الأدوات والإخراج المنظم والقيود الخاصة بالنموذج.

## بث الإخراج

عيِّن خيار البث للبروتوكول واستهلك أحداث الخادم المُرسَلة المُعادة
بشكل تدريجي. بالنسبة لـ Chat Completions، أضف `"stream": true`؛ وبالنسبة
للاستدعاءات المتوافقة مع Gemini، استخدم عملية `:streamGenerateContent`.
أغلق الدفق عندما يتلقى عميلك الحدث النهائي للبروتوكول.

## فحص دقة التسليم

تتضمن كل استجابة LLM مقبولة الرأسَ `X-RunAPI-Fidelity`. تعني القيمة `full` أن الطلب سُلِّم دون حذف. وتعني القيمة `lossy` أن RunAPI حذفت ضوابط اختيارية لإتمام الطلب؛ ويحتوي `X-RunAPI-Omitted-Fields` على أسماء الحقول المحذوفة مفصولةً بفواصل. تُرفض الطلبات التي لا يمكن الحفاظ فيها على دلالات دورة الحياة الإلزامية أو الاستمرارية أو الأدوات أو العناصر المكتوبة قبل إنشاء مهمة Task.

يظهر كلا الترويستين عبر CORS، لذا يمكن لعملاء المتصفح فحصهما. سجّلهما مع معرّف الطلب عندما تكون سلوكيات التسليم الدقيقة مهمة للتطبيق.

## معالجة الأخطاء والاستخدام

عامِل `401` على أنه فشل مصادقة، وردود `4xx` على أنها مشكلات في الطلب أو السياسة، وأعد المحاولة فقط في حالات فشل الخادم أو الشبكة العابرة. اقرأ استخدام الرموز من الاستجابة النهائية أو حدث البث النهائي في شكل البروتوكول المحدد، واحتفظ بمعرّفات الطلبات في سجلات التطبيق للدعم الفني.

---

## المزيد من RunAPI

- [الرئيسية](https://runapi.ai/ar/.md)
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models)
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt)

التواصل: contact@runapi.ai

## البيانات المنظمة

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "TechArticle",
    "headline": "البدء السريع",
    "description": "استدع نماذج اللغة في RunAPI عبر بروتوكول متزامن أو دفقي مدعوم.",
    "url": "https://runapi.ai/ar/docs/guides/llm-api/quickstart",
    "mainEntityOfPage": "https://runapi.ai/ar/docs/guides/llm-api/quickstart"
  }
]
```