---
title: "بدء سريع لـ LLM API عبر curl: محادثة وبث وتفريغ صوتي"
description: "نفّذ أول استدعاءاتك لـ BroadNet Inference عبر curl: إكمال محادثة، وإجابة ببث متدفق، وتحويل صوت إلى نص، ثم اقرأ الاستجابة والاستهلاك والأخطاء."
url: https://broadrouter.com/ar/guides/curl-quickstart/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# أول طلب إلى BroadNet Inference باستخدام curl

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

أرسل طلب POST إلى https://inference.broadnet.ai/v1/chat/completions مع الترويسة Authorization Bearer ومفتاحك، وجسم JSON يحتوي على model، مثل broadnet/gemma-4-26b-a4b، وعلى messages. أضف stream true للبث المتدفق. أما الصوت فأرسل نموذج multipart يضم model وlanguage وfile إلى /v1/audio/transcriptions.

تنقلك هذه الصفحة من مفتاح جديد إلى ثلاثة استدعاءات تعمل: إكمال محادثة، وإجابة ببث متدفق، وتفريغ صوتي. كل ما تحتاجه هو curl. يستخدم BroadNet Inference صيغة طلبات OpenAI، فإذا نجحت هذه الاستدعاءات، فستعمل أيضًا أي [حزمة SDK متوافقة مع OpenAI](https://broadrouter.com/ar/guides/openai-python-sdk/) أو أي أداة متوافقة.

## 1\. اضبط مفتاحك

أنشئ مفتاحًا في لوحة تحكم BroadNet. تحصل الحسابات الجديدة على رصيد مبدئي قدره $5.

```bash
export BROADNET_API_KEY='paste-your-key'
```

أرسل المفتاح في الترويسة `Authorization: Bearer` فقط.

## 2\. أول إكمال محادثة

نموذج BroadNet Gemma 4 VL 26B هو نموذج المحادثة الوحيد الذي يعمل بالرصيد المبدئي، فابدأ به:

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/gemma-4-26b-a4b",
    "messages": [{"role": "user", "content": "Say hello in English and Arabic."}]
  }'
```

الرد بصيغة JSON القياسية لإكمال المحادثات. تجد الإجابة في `choices[0].message.content`، ويحتوي `usage` على أعداد الرموز (التوكنات) التي تدفع ثمنها.

## 3\. جرّب نموذج استدلال منطقي

بعد شحن الرصيد، غيّر النموذج. تُجري نماذج GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash استدلالًا منطقيًا قبل أن تجيب، ويُحتسب هذا الاستدلال ضمن `max_tokens`:

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/glm-5.3",
    "max_tokens": 2000,
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
  }'
```

إذا كان `content` فارغًا وكانت قيمة `finish_reason` هي `length`، فقد نفدت الميزانية أثناء الاستدلال. راجع [لماذا تُرجع نماذج الاستدلال المنطقي إجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).

## 4\. بثّ الرد

أضف `"stream": true` وأوقف التخزين المؤقت لمخرجات curl بالخيار `-N`:

```bash
curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count to five."}]}'
```

تصلك أحداث Server-Sent Events. ينتهي البث بالسطر الحرفي `data: [DONE]`، ومع `include_usage` يحمل آخر جزء أعداد الرموز. التفاصيل في [البث المتدفق لإكمال المحادثات](https://broadrouter.com/ar/guides/streaming-chat-completions/).

## 5\. حوّل الصوت إلى نص

يستقبل التفريغ الصوتي نموذج multipart. أرسل ملف WAV أو MP3 لا يتجاوز 26,214,400 بايت، وأرسل `language` دائمًا:

```bash
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe \
  -F language=en \
  -F file=@meeting.mp3
```

الاستجابة بصيغة JSON والنص المفرّغ في `text`. تحتاج الملاحظات الصوتية من WhatsApp بصيغة `.ogg` والتسجيلات بصيغة `.m4a` إلى التحويل أولًا؛ راجع [كيف تفرّغ ملاحظات WhatsApp الصوتية](https://broadrouter.com/ar/guides/transcribe-whatsapp-voice-notes/). وللعربية، استخدم `broadnet/cohere-transcribe-arabic` مع `language=ar`؛ راجع [دليل تحويل الصوت العربي إلى نص](https://broadrouter.com/ar/guides/arabic-speech-to-text-api/). يكلّف النموذج متعدد اللغات $0.002 لكل دقيقة صوت، والنموذج العربي $0.0042.

## أي نموذج تختار؟

| النموذج | المعرّف | نقطة النهاية | الرصيد المجاني |
| --- | --- | --- | --- |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | `/v1/chat/completions` | نعم |
| GLM 5.3 | `broadnet/glm-5.3` | `/v1/chat/completions` | لا |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | `/v1/chat/completions` | لا |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | `/v1/chat/completions` | لا |
| BroadNet Transcribe | `broadnet/cohere-transcribe` | `/v1/audio/transcriptions` | نعم |
| BroadNet Transcribe Arabic | `broadnet/cohere-transcribe-arabic` | `/v1/audio/transcriptions` | نعم |

تجد الأسعار لكل رمز ولكل دقيقة في [صفحة الأسعار](https://broadrouter.com/ar/pricing/). ولكل نموذج صفحة خاصة به، مثل [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/).

## حل المشكلات

-   **401.** المفتاح مفقود أو غير صالح أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. تأكّد من عدم وجود مسافات زائدة حول المفتاح.
-   **خطأ في الحقل model.** انسخ المعرّف من الجدول؛ فهو يتضمّن البادئة `broadnet/`. وتفشل النماذج المدفوعة مع الرصيد المبدئي إلى أن تشحن رصيدك.
-   **413.** حجم الملف الصوتي يتجاوز 26,214,400 بايت. قسّمه.
-   **403.** رفضت قائمة عناوين IP المسموح بها للمفتاح، أو سياسة النموذج أو المسار، الطلبَ. راجع [قوائم عناوين IP المسموح بها لمفاتيح API](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات قيد التنفيذ في آنٍ واحد. انتظر مدة متزايدة ثم أعد المحاولة. راجع [رموز أخطاء BroadNet وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **على خطة غير محدودة.** كل [جلسة في الخطة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) تنفّذ طلبًا واحدًا في كل مرة، فشغّل حلقات curl المتوازية على جلسات منفصلة. ولا تعمل مفاتيح الخطط إلا مع `broadnet/deepseek-v4.1-flash`.

احفظ ترويسة الاستجابة `X-Request-ID` (`curl -D headers.txt ...`) عند الإبلاغ عن مشكلة.

## مصطلحات في هذا الدليل

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[قائمة عناوين IP المسموحة (IP allow list)](https://broadrouter.com/ar/glossary/ip-allow-list/)

قائمة عناوين IP المسموحة (IP allow list) ضابط أمني يقبل الطلبات من عناوين IP أو نطاقات CIDR المدرجة فقط ويرفض كل ما عداها. وفي واجهات API تحدّ من ضرر تسرّب المفتاح، لأن المفتاح لا يعمل من شبكات غير مدرجة في القائمة.

[ملف WAV](https://broadrouter.com/ar/glossary/wav/)

WAV (Waveform Audio File Format، أو WAVE) حاوية صوتية مبنية على صيغة RIFF من Microsoft وIBM. تحمل عادةً عينات PCM خطية غير مضغوطة، فيكون حجمها متوقَّعًا: معدل العينات مضروبًا في عدد بايتات العينة مضروبًا في عدد القنوات، لكل ثانية.

[الأحداث التي يرسلها الخادم (SSE)](https://broadrouter.com/ar/glossary/sse/)

الأحداث التي يرسلها الخادم (server-sent events أو SSE) معيار ويب يتيح للخادم دفع تدفق من الأحداث النصية إلى العميل عبر استجابة HTTP واحدة طويلة الأمد بنوع المحتوى text/event-stream. وكل حدث سطر حقل أو أكثر، مثل data:، ينتهي بسطر فارغ.

[البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/)

البث المتدفق (streaming) طريقة لإرجاع استجابة النموذج اللغوي على أجزاء صغيرة أثناء توليدها، بدل إرجاعها ردًا واحدًا في النهاية. وتبث الواجهات المتوافقة مع OpenAI عبر أحداث يرسلها الخادم (server-sent events) حين يضبط الطلب stream على true.

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

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

### أي نموذج يمكنني استدعاؤه بالرصيد المبدئي المجاني؟

نموذج BroadNet Gemma 4 VL 26B، بالمعرّف broadnet/gemma-4-26b-a4b، ونموذجا التفريغ الصوتي كلاهما. أما GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash فتتطلب شحن الرصيد.

### لماذا يصل محتوى الرسالة فارغًا في استجابة curl؟

تُنفق نماذج الاستدلال المنطقي max\_tokens على الاستدلال أولًا. إذا كانت قيمة finish\_reason هي length، فارفع max\_tokens إلى 1,000 أو أكثر.

### لماذا يظهر النص العربي المفرّغ بحروف لاتينية؟

لم يتضمّن الطلب الحقل language. أرسل language=ar للعربية، ورمز ISO 639-1 المناسب للغات الأخرى.

### هل يعرض GET /v1/models كل النماذج التي يمكنني استدعاؤها؟

تقول وثائق BroadNet إن GET /v1/models "supplies public catalogue metadata for external monitors" (الترجمة: «يوفّر بيانات وصفية عامة للكتالوج لأدوات المراقبة الخارجية»). استخدم في طلباتك معرّفات النماذج الواردة في المرجع التقني أو في pricing.json.

## أدلة ذات صلة

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [API لتحويل الصوت العربي إلى نص خطوة بخطوة](https://broadrouter.com/ar/guides/arabic-speech-to-text-api/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)

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

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

**المصادر**

-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-curl-quickstart&utm_content=sources)
-   [قائمة النماذج والأسعار بصيغة قابلة للقراءة آليًا (pricing.json) (بالإنجليزية)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-curl-quickstart&utm_content=sources)
