# مزودو الاستدلال

توفر صفحات النماذج على Hugging Face استدلالًا بنظام الدفع حسب الاستخدام لآلاف النماذج، مما يتيح لك تجربتها جميعًا مباشرةً في المتصفح. تعمل الخدمة بواسطة مزودي الاستدلال (Inference Providers)، مع اعتمادات شهرية مضمّنة لمستخدمي PRO ومنظمات Team & Enterprise.

توفّر مزوّدي الاستدلال للمطوّرين وصولاً موحّداً ومبسّطاً إلى مئات نماذج تعلّم الآلة، مدعوماً بأفضل شركاء الاستدلال الخادمي. 👉 **للاطلاع على التوثيق الكامل، زر [توثيق مزوّدي الاستدلال](https://huggingface.co/docs/inference-providers)**.

## مزودو الاستدلال على المستودع

يتكامل مزوّدو الاستدلال بشكل وثيق مع Hugging Face Hub، ويمكنك استخدامه بعدة طرق مختلفة:

- **المكونات التفاعلية** - اختبر النماذج مباشرةً على صفحات النماذج باستخدام مكونات تفاعلية تعتمد على مزودي الاستدلال (Inference Providers) في الخلفية. اطّلع على [صفحة نموذج DeepSeek-R1-0528](https://huggingface.co/deepseek-ai/DeepSeek-R1-0528) كمثال.
- **ساحة الاستدلال** - اختبر وقارن نماذج إكمال المحادثة بسهولة باستخدام أوامرك. اطّلع على [ساحة الاستدلال](https://huggingface.co/playground) للبدء.
- **البحث** - قم بتصفية النماذج حسب مزود الاستدلال في [صفحة النماذج](https://huggingface.co/models?inference_provider=all) للعثور على النماذج المتاحة عبر مزودين محددين.
- **Data Studio** - استخدم الذكاء الاصطناعي لاستكشاف مجموعات البيانات على Hub. جرّب [Data Studio](https://huggingface.co/datasets/fka/awesome-chatgpt-prompts/viewer?views%5B%5D=train) على مجموعة البيانات المفضلة لديك.

## البناء مع مزوّدي الاستدلال

يمكنك دمج مزودي الاستدلال في تطبيقاتك الخاصة باستخدام مكتباتنا البرمجية أو عملاء HTTP. فيما يلي دليل سريع للبدء باستخدام Python وJavaScript، وللاطلاع على مزيد من التفاصيل، راجع [توثيق مزودي الاستدلال](https://huggingface.co/docs/inference-providers).

يمكنك استخدام حزمة Python SDK الخاصة بنا للتفاعل مع مزودي الاستدلال.

```python
from huggingface_hub import InferenceClient

import os

client = InferenceClient(
    api_key=os.environ["HF_TOKEN"],
    provider="auto",   # Automatically selects best provider
)

# Chat completion
completion = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3-0324",
    messages=[{"role": "user", "content": "A story about hiking in the mountains"}]
)

# Image generation
image = client.text_to_image(
    prompt="A serene lake surrounded by mountains at sunset, photorealistic style",
    model="black-forest-labs/FLUX.1-dev"
)

```

أو يمكنك ببساطة استخدام عميل متوافق مع واجهة OpenAI API.

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://router.huggingface.co/v1",
    api_key=os.environ["HF_TOKEN"],
)

completion = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3-0324",
    messages=[
        {
            "role": "user",
            "content": "A story about hiking in the mountains"
        }
    ],
)
```

> [!WARNING]
> لا يُدعم العميل المتوافق مع واجهة OpenAI البرمجية لتوليد الصور.

يمكنك استخدام حزمة تطوير البرمجيات (SDK) الخاصة بنا بلغة JavaScript للتفاعل مع مزودي الاستدلال.

```javascript
import { InferenceClient } from "@huggingface/inference";

const client = new InferenceClient(process.env.HF_TOKEN);

const chatCompletion = await client.chatCompletion({
    provider: "auto",  // Automatically selects best provider  
    model: "deepseek-ai/DeepSeek-V3-0324",
    messages: [{ role: "user", content: "Hello!" }]
});

const imageBlob = await client.textToImage({
  model: "black-forest-labs/FLUX.1-dev",
  inputs:
    "A serene lake surrounded by mountains at sunset, photorealistic style",
});
```

أو يمكنك ببساطة استخدام عميل متوافق مع واجهة OpenAI API.

```javascript
import { OpenAI } from "openai";

const client = new OpenAI({
  baseURL: "https://router.huggingface.co/v1",
  apiKey: process.env.HF_TOKEN,
});

const completion = await client.chat.completions.create({
  model: "meta-llama/Llama-3.1-8B-Instruct",
  messages: [{ role: "user", content: "A story about hiking in the mountains" }],
});

```

> [!WARNING]
> لا يُدعم العميل المتوافق مع واجهة OpenAI البرمجية لتوليد الصور.

ستحتاج إلى رمز Hugging Face يتمتع بصلاحيات الاستدلال. أنشئ رمزًا في [الإعدادات > الرموز](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained).

### كيف يعمل مزودو الاستدلال

للغوص بشكل أعمق في مزودي الاستدلال، اطّلع على [توثيق مزودي الاستدلال](https://huggingface.co/docs/inference-providers). فيما يلي بعض الموارد الرئيسية:

- **[البدء السريع](https://huggingface.co/docs/inference-providers)**
- **[دليل التسعير والفوترة](https://huggingface.co/docs/inference-providers/pricing)**
- **[تفاصيل التكامل مع Hub](https://huggingface.co/docs/inference-providers/hub-integration)**

### ما هو واجهة برمجة تطبيقات HF-Inference؟

تُعد واجهة HF-Inference API واحدة من المزودين المتاحين عبر مزودي الاستدلال. وقد كان اسمها السابق "Inference API (serverless)"، وهي تعمل في الخلفية بواسطة [Inference Endpoints](https://huggingface.co/docs/inference-endpoints/index).

لمزيد من التفاصيل حول مزوّد HF-Inference على وجه التحديد، راجع [صفحته المخصصة](https://huggingface.co/docs/inference-providers/providers/hf-inference).