---
title: "ما هو max_tokens في LLM API؟ شرح حد المخرجات | BroadRouter"
description: "يضع max_tokens سقفًا لعدد الرموز التي يولّدها النموذج في رد واحد. كيف يختلف عن نافذة السياق، وما أسماؤه الأحدث، ولماذا تحتاج نماذج الاستدلال المنطقي إلى مساحة أكبر."
url: https://broadrouter.com/ar/glossary/max-tokens/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# max\_tokens (الحد الأقصى لرموز المخرجات)

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

max\_tokens معامل في واجهات LLM API يحدد أقصى عدد من الرموز يمكن أن يولّده النموذج في استجابة واحدة. وحين يبلغ التوليد هذا الحد يتوقف، وتُعلَّم الاستجابة بأنها مقطوعة، مثلًا بضبط finish\_reason على "length".

يُسمّى أيضًا: الحد الأقصى للرموز، حد رموز المخرجات، الحد الأقصى لطول المخرجات، max\_tokens، max\_completion\_tokens، max\_output\_tokens، output token limit، maximum output length

`max_tokens` هو ميزانية المخرجات لرد واحد. وهو يحميك من الإجابات الجامحة، لكنه إن ضُبط منخفضًا جدًا قطع الإجابات أو لم يُرجع شيئًا على الإطلاق.

## كيف يعمل

يولّد النموذج [رمزًا](https://broadrouter.com/ar/glossary/token/) واحدًا في كل مرة. وحين يبلغ العدد `max_tokens` يتوقف التوليد، ولو في منتصف الجملة. ثم تذكر الاستجابة سبب انتهائها:

| `finish_reason` | المعنى |
| --- | --- |
| `stop` | أنهى النموذج من تلقاء نفسه |
| `length` | بلغ التوليد حد `max_tokens` |
| `tool_calls` | يطلب النموذج استدعاء أداة |

لهذا المعامل عدة أسماء. فواجهة Chat Completions من OpenAI تعلّم الآن `max_tokens` بأنه مُهمَل لصالح `max_completion_tokens`، وهو حد أعلى يشمل المخرجات الظاهرة ورموز الاستدلال المنطقي معًا. وتستخدم Responses API من OpenAI الاسم `max_output_tokens`، وتستخدم Messages API من Anthropic الاسم `max_tokens`. ويقبل كثير من المزوّدين المتوافقين مع OpenAI الاسم `max_tokens`.

يتشارك الأمر والمخرجات [نافذة سياق](https://broadrouter.com/ar/glossary/context-window/) واحدة. فإن كانت النافذة 32,768 رمزًا والأمر 30,000، فلن يعود أكثر من 2,768 رمزًا، مهما كانت قيمة `max_tokens`.

## لماذا يهم

-   **ضبط التكلفة.** على مفتاح يُحاسَب بالرمز، يمثّل `max_tokens` أقصى ما يمكن أن يكلّفه رد واحد من المخرجات.
-   **الإجابات الفارغة.** في نماذج الاستدلال المنطقي، يُقتطع التفكير من الميزانية نفسها. وقد يُنفَق حد قدره 100 بالكامل على [رموز الاستدلال المنطقي](https://broadrouter.com/ar/glossary/reasoning-tokens/)، فتأتي الإجابة الظاهرة فارغة ويكون `finish_reason` بالقيمة `length`.
-   **JSON معطوب.** الرد المقطوع يترك [المخرجات المنظَّمة](https://broadrouter.com/ar/glossary/structured-output/) ناقصة وغير قابلة للتحليل. افحص `finish_reason` قبل التحليل.

## في BroadNet Inference

تستدل نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B قبل الإجابة، ويقول توثيق BroadNet إن الاستدلال المنطقي يُحتسب ضمن `max_tokens`. اسمح بـ 1,000 رمز أو أكثر، أو اتركه دون ضبط، أو اخفض `reasoning_effort`:

```python
response = client.chat.completions.create(
    model="broadnet/glm-5.3",
    max_tokens=2000,
    messages=[{"role": "user", "content": "Summarize this contract clause."}],
)
if response.choices[0].finish_reason == "length":
    print("Cut off: raise max_tokens or lower reasoning_effort")
```

تختلف أحجام السياق باختلاف النموذج: 1,048,576 رمزًا لنموذجَي DeepSeek V4.1 Flash وGLM 5.3، و262,144 لنموذج Qwen3.8 27B، و32,768 لنموذج BroadNet Gemma 4 VL 26B. راجع [صفحات النماذج](https://broadrouter.com/ar/models/) و[لماذا تُرجع نماذج الاستدلال المنطقي إجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).

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

-   نسخ حد صغير من نموذج لا يستدل أثناء الانتقال. راجع [قائمة التحقق للانتقال](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/).
-   اعتبار `length` نجاحًا. سجّله وأعد المحاولة بمساحة أكبر.

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

### هل max\_tokens هو نفسه نافذة السياق؟

لا. نافذة السياق هي المجموع الذي يستطيع النموذج التعامل معه، أي الأمر والمخرجات معًا. أما max\_tokens فيحدّ المخرجات وحدها، ويجب أن يتسع الأمر مع max\_tokens داخل النافذة.

### هل ينبغي أن أضبط max\_tokens دائمًا؟

اضبطه حين تحتاج إلى سقف صارم للتكلفة أو الطول. واترك مساحة سخية في نماذج الاستدلال المنطقي، أو اتركه دون ضبط إن كانت القيمة الافتراضية لدى المزوّد كبيرة بما يكفي.

### ما الفرق بين max\_tokens وmax\_completion\_tokens؟

أهملت OpenAI المعامل max\_tokens في Chat Completions لصالح max\_completion\_tokens، الذي يشمل رموز الاستدلال المنطقي صراحةً. ولا يزال كثير من المزوّدين المتوافقين مع OpenAI يقبلون max\_tokens.

## انظر أيضًا

-   [رموز الاستدلال المنطقي (Reasoning tokens)](https://broadrouter.com/ar/glossary/reasoning-tokens/) (مصطلح)
-   [نافذة السياق (Context window)](https://broadrouter.com/ar/glossary/context-window/) (مصطلح)
-   [رموز الإدخال والإخراج (Input and output tokens)](https://broadrouter.com/ar/glossary/input-and-output-tokens/) (مصطلح)
-   [المخرجات المنظَّمة (Structured output)](https://broadrouter.com/ar/glossary/structured-output/) (مصطلح)
-   [وضع JSON (JSON mode)](https://broadrouter.com/ar/glossary/json-mode/) (مصطلح)
-   [سلسلة التفكير (Chain-of-thought، CoT)](https://broadrouter.com/ar/glossary/chain-of-thought/) (مصطلح)
-   [سبب الانتهاء (finish\_reason)](https://broadrouter.com/ar/glossary/finish-reason/) (مصطلح)
-   [تسلسلات التوقف (Stop sequences)](https://broadrouter.com/ar/glossary/stop-sequences/) (مصطلح)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/) (دليل)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [الانتقال إلى واجهة API متوافقة مع OpenAI: قائمة تحقق للترحيل](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/) (مقال)

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

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

**المصادر**

-   [مرجع OpenAI API، إنشاء إكمال محادثة (max\_tokens وmax\_completion\_tokens)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI، نماذج الاستدلال المنطقي (max\_output\_tokens والاستجابات غير المكتملة)](https://developers.openai.com/api/docs/guides/reasoning)
-   [المرجع التقني لـ BroadNet Inference API، نماذج الاستدلال المنطقي (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-max-tokens&utm_content=sources#models)
