Text
Grok 4.7
استخدم Grok 4.7 بطلبات Chat Completions أو Responses أو Messages الأصلية. تعرّف على المعلمات والبث والاستخدام وحدود الإمكانات الحالية.
استخدم grok-4.7 بأحد التنسيقات الثلاثة أدناه. تتم المصادقة باستخدام مفتاح API الخاص بك في SeedRouter. تتضمن صفحة النموذج ساحة تجربة وأسعار الرموز الحالية، ويشرح دليل الأسعار الإدخال المخزّن مؤقتًا والاستدلال.
البدء السريع
curl https://api.seedrouter.ai/v1/responses \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"grok-4.7","input":"What is 2 + 2?","reasoning":{"effort":"low"},"max_output_tokens":64,"store":false}'تتضمن استجابة JSON عناصر output وusage. احتفظ بجميع عناصر الإخراج عند إنشاء سجل المحادثة، بما فيها عناصر الاستدلال والأدوات.
تنسيقات الطلبات
| التنسيق | نقطة النهاية | الحقول المطلوبة |
|---|---|---|
| Responses | POST /v1/responses | model, input |
| Chat Completions | POST /v1/chat/completions | model, messages |
| Messages | POST /v1/messages | model, messages, max_tokens |
استخدم Content-Type: application/json وAuthorization: Bearer $SEEDROUTER_API_KEY. يمكن لعملاء Messages أيضًا إرسال anthropic-version: 2023-06-01.
المعلمات والقيود
تحتوي مواصفة OpenAPI على مخططات الطلب والاستجابة المتداخلة كاملة. تسرد الجداول أدناه جميع حقول الطلب المدعومة في المستوى الأعلى. تُستبعد الحقول غير المعروفة والمعلمات التي يتجاهلها هذا النموذج رسميًا. وتظل قيمة المعلمة المدعومة غير الصالحة غير صالحة.
تقبل الحقول الاختيارية التي تسمح بالقيمة الخالية null بشكل صريح؛ وعند حذف الحقل تُستخدم قيمته الافتراضية في API. تخفي ساحة التجربة user وتثبّت model على grok-4.7. ويظل بإمكان عملاء API إرسال user.
- السياق: 500,000 رمز، تشمل المحادثة والإخراج.
- مستوى الاستدلال:
lowوmediumوhighوxhigh؛ الافتراضيhigh. - القيمة الافتراضية لكل من
max_completion_tokensوmax_output_tokensهي 128,000 رمز إخراج مرئي. لا تدخل رموز الاستدلال واستدعاءات الدوال ضمن حد الإخراج المرئي هذا. هذه قيمة افتراضية وليست ادعاءً بشأن أقصى قدرة للإخراج. - يجب أن تكون حدود الإخراج أعدادًا صحيحة موجبة. تفرض API أيضًا سقف الأمان الحالي للأعداد الصحيحة البالغ 1,073,741,823؛ وتظل سعة السياق قيدًا مطبقًا.
temperature: من 0 إلى 2، والافتراضي 1.top_p: أكبر من 0 ولا يزيد على 1، والافتراضي 1. في Responses، يتراوحmin_pمن 0 إلى 1، ويكونtop_kعددًا صحيحًا لا يقل عن 1.- حتى 350 تعريفًا للأدوات. يتطلب
stream_optionsضبطstream: true. - لا يمكن الجمع بين
instructionsوprevious_response_id. ملخصات الاستدلال مفصلة دائمًا.
معلمات Responses
| الحقل | النوع | القاعدة |
|---|---|---|
include | مصفوفة أو null | مصفوفة بحقول الاستجابة الإضافية المطلوب تضمينها. |
input (مطلوب) | كائن أو صيغة بديلة مدعومة | سلسلة نصية أو مصفوفة كاملة من عناصر الإدخال. |
instructions | سلسلة نصية أو null | تعليمات النظام؛ لا يمكن الجمع بينها وبين previous_response_id. |
max_output_tokens | عدد صحيح أو null | حد الإخراج المرئي؛ الافتراضي 128,000. |
max_turns | عدد صحيح أو null | أقصى عدد لجولات الوكيل بصيغة عدد صحيح. |
min_p | عدد أو null | عدد من 0 إلى 1. |
model (مطلوب) | سلسلة نصية | ثابت على grok-4.7. |
parallel_tool_calls | قيمة منطقية أو null | قيمة منطقية؛ الافتراضي true. |
previous_response_id | سلسلة نصية أو null | معرّف الاستجابة بصيغة سلسلة نصية؛ المتابعة بالمعرّف غير متاحة حاليًا. |
prompt_cache_key | سلسلة نصية أو null | مفتاح التخزين المؤقت بصيغة سلسلة نصية. |
reasoning | كائن | إعدادات الاستدلال؛ المستوى الافتراضي high. |
reasoning_effort | سلسلة نصية أو null | low وmedium وhigh وxhigh؛ الافتراضي high. |
safety_identifier | سلسلة نصية أو null | معرّف أمان اختياري يقدمه المستدعي. |
search_parameters | كائن | إعدادات البحث. |
service_tier | سلسلة نصية | auto وdefault وpriority وfast؛ تضاعف priority وfast أسعار الرموز. |
store | قيمة منطقية أو null | قيمة منطقية؛ الافتراضي true. عمليات الاستجابات المخزنة غير متاحة حاليًا. |
stream | قيمة منطقية أو null | قيمة منطقية؛ الافتراضي false. |
temperature | عدد أو null | عدد من 0 إلى 2؛ الافتراضي 1. |
text | كائن | إعدادات الاستجابة النصية، بما فيها format. |
tool_choice | كائن أو صيغة بديلة مدعومة | تلقائي أو معطّل أو إلزامي أو أداة محددة؛ تعتمد الصيغة على التنسيق. |
tools | مصفوفة أو null | تعريفات الأدوات؛ بحد أقصى 350. |
top_k | عدد صحيح أو null | عدد صحيح؛ يتطلب Responses قيمة لا تقل عن 1. |
top_p | عدد أو null | عدد أكبر من 0 ولا يزيد على 1؛ الافتراضي 1. |
user | سلسلة نصية أو null | معرّف اختياري يقدمه المستدعي؛ مخفي في ساحة التجربة. |
معلمات Chat Completions
| الحقل | النوع | القاعدة |
|---|---|---|
deferred | قيمة منطقية أو null | قيمة منطقية؛ الافتراضي false. الإكمال المؤجل غير متاح حاليًا. |
max_completion_tokens | عدد صحيح أو null | حد الإخراج المرئي؛ الافتراضي 128,000. |
max_tokens | عدد صحيح أو null | حد موجب للإخراج المرئي. مطلوب في Messages. |
messages (مطلوب) | مصفوفة | رسائل المحادثة بهذا التنسيق. |
model (مطلوب) | سلسلة نصية | ثابت على grok-4.7. |
n | عدد صحيح أو null | عدد صحيح لا يقل عن 1؛ الافتراضي 1. |
parallel_tool_calls | قيمة منطقية أو null | قيمة منطقية؛ الافتراضي true. |
prompt_cache_key | سلسلة نصية أو null | مفتاح التخزين المؤقت بصيغة سلسلة نصية. |
reasoning_effort | سلسلة نصية أو null | low وmedium وhigh وxhigh؛ الافتراضي high. |
response_format | كائن أو صيغة بديلة مدعومة | نص أو كائن JSON أو إخراج وفق مخطط JSON. |
safety_identifier | سلسلة نصية أو null | معرّف أمان اختياري يقدمه المستدعي. |
search_parameters | كائن | إعدادات البحث. |
seed | عدد صحيح أو null | قيمة أولية صحيحة لأخذ العينات. |
service_tier | سلسلة نصية | auto وdefault وpriority وfast؛ تضاعف priority وfast أسعار الرموز. |
stream | قيمة منطقية أو null | قيمة منطقية؛ الافتراضي false. |
stream_options | كائن | خيارات البث؛ تتطلب stream: true. |
temperature | عدد أو null | عدد من 0 إلى 2؛ الافتراضي 1. |
tool_choice | كائن أو صيغة بديلة مدعومة | تلقائي أو معطّل أو إلزامي أو أداة محددة؛ تعتمد الصيغة على التنسيق. |
tools | مصفوفة أو null | تعريفات الأدوات؛ بحد أقصى 350. |
top_p | عدد أو null | عدد أكبر من 0 ولا يزيد على 1؛ الافتراضي 1. |
user | سلسلة نصية أو null | معرّف اختياري يقدمه المستدعي؛ مخفي في ساحة التجربة. |
web_search_options | كائن | خيارات البحث للتوافق. |
معلمات Messages
| الحقل | النوع | القاعدة |
|---|---|---|
max_tokens (مطلوب) | عدد صحيح | حد موجب للإخراج المرئي. مطلوب في Messages. |
messages (مطلوب) | مصفوفة | رسائل المحادثة بهذا التنسيق. |
metadata | كائن | كائن البيانات الوصفية لـ Messages. |
model (مطلوب) | سلسلة نصية | ثابت على grok-4.7. |
stop_sequences | مصفوفة أو null | مصفوفة من سلاسل الإيقاف. |
stream | قيمة منطقية أو null | قيمة منطقية؛ الافتراضي false. |
system | كائن أو صيغة بديلة مدعومة | سلسلة النظام النصية أو كتل المحتوى. |
temperature | عدد أو null | عدد من 0 إلى 2؛ الافتراضي 1. |
tool_choice | كائن أو صيغة بديلة مدعومة | تلقائي أو معطّل أو إلزامي أو أداة محددة؛ تعتمد الصيغة على التنسيق. |
tools | مصفوفة أو null | تعريفات الأدوات؛ بحد أقصى 350. |
top_k | عدد صحيح أو null | عدد صحيح؛ يتطلب Responses قيمة لا تقل عن 1. |
top_p | عدد أو null | عدد أكبر من 0 ولا يزيد على 1؛ الافتراضي 1. |
البث
اضبط stream على true. يرسل Chat أجزاء الإكمال؛ ويرسل Responses أحداث استجابة مسماة؛ ويرسل Messages أحداث الرسائل وكتل المحتوى. اقرأ حدث الاستخدام النهائي إلى جانب إضافات النص. قد تكون استدعاءات الأدوات والاستدلال عناصر إخراج منفصلة؛ لا تختزل البث في النص المرئي عند الاحتفاظ بالسجل.
{
"model": "grok-4.7",
"input": "Explain a mutex in one sentence.",
"reasoning": { "effort": "low" },
"max_output_tokens": 128,
"store": false,
"stream": true
}الأدوات والإخراج المنظّم
استخدم تعريف الأداة المناسب للتنسيق المختار. يستخدم Chat الحقل response_format، ويستخدم Responses الحقل text.format. جرى اختبار الدوال والبحث على الويب والبحث في X ومفسّر الشيفرة واستدعاءات MCP مع هذا النموذج. يعيد Shell استدعاءً ينفذه العميل؛ ولا يشغّل أمرًا على حاسوبك تلقائيًا. يصف المخطط الكامل أنواع أدوات أخرى أيضًا؛ لكن وجود بند في المخطط وحده لا يثبت أن خدمة خارجية محددة قد ضُبطت.
{
"model": "grok-4.7",
"input": "Use the code interpreter once to compute 13*17. Return the number.",
"tools": [{ "type": "code_interpreter" }],
"tool_choice": "required",
"max_turns": 1,
"reasoning": { "effort": "low" },
"max_output_tokens": 32,
"store": false
}تُحتسب رسوم استخدام الأدوات منفصلة عن الرموز. يعتمد البحث على الويب ومفسّر الشيفرة على عدد الاستدعاءات. ويعتمد البحث في X على عدد المنشورات والملفات الشخصية التي تم جلبها، بما فيها العناصر التي تُجلب مرارًا؛ وعدد استدعاءات البحث في X ليس وحدة الفوترة. راجع usage.server_side_tool_usage_details وسجلات الاستخدام في حسابك.
الاستخدام والأسعار
تعتمد الأسعار على إجمالي طول الإدخال. استخدم الشريحة القياسية عندما يكون الإدخال أقل من 200,000 رمز. عند 200,000 رمز أو أكثر، تُطبق شريحة السياق الطويل على الطلب بأكمله؛ ويُحتسب الإدخال المخزّن مؤقتًا عند اختيار الشريحة. يضاعف service_tier: "priority" و"fast" أسعار الرموز في الشريحتين. يختار auto وdefault الخدمة القياسية. تُحسب رسوم الأدوات بصورة منفصلة ولا تتضاعف بفعل مضاعف الرموز هذا.
| التنسيق | احتساب الإدخال | احتساب الإخراج |
|---|---|---|
| Responses | يتضمن input_tokens الحقل input_tokens_details.cached_tokens | يتضمن output_tokens الاستدلال؛ لا تضف تفاصيل الاستدلال مرة أخرى |
| Chat | يتضمن prompt_tokens الحقل prompt_tokens_details.cached_tokens | يبلّغ xAI عن completion_tokens المرئية بصورة منفصلة؛ إجمالي الإخراج القابل للفوترة هو total_tokens - prompt_tokens، بما فيه الاستدلال |
| Messages | لا يتضمن input_tokens الحقل cache_read_input_tokens؛ أضف حقول التخزين المؤقت للحصول على إجمالي الإدخال | output_tokens هو إجمالي الإخراج |
تتضمن الاستجابات العامة عدادات الاستخدام، لا حقول التكلفة النقدية. تعرض سجلات الاستخدام المبلغ النهائي. لا تُفرض رسوم على الطلبات الفاشلة.
سجل المحادثة والقيود الحالية
للمتابعة دون حالة محفوظة، أرسل الإدخال السابق وكل عنصر إخراج مُعاد ورسالة المستخدم التالية كقيمة input جديدة. في Chat أو Messages، أرسل سجل الرسائل الكامل بالتنسيق المقابل. حافظ على عناصر الاستدلال المشفّر والأدوات دون تغيير عند إعادتها.
لا تستطيع الخدمة الحالية المتابعة باستخدام previous_response_id، أو استرجاع استجابة محفوظة أو حذفها، أو سرد عناصر الإدخال المحفوظة، أو إعادة إكمالات Chat المؤجلة. قد تُقبل store: true عند الإنشاء، لكن ذلك لا يثبت دعم حفظ الاستجابات أو استرجاعها. تظل هذه الحقول في العقد الرسمي وساحة التجربة؛ وهذا القيد لا يعيد تعريف سلوكها المفترض.
لم تعمل مرفقات الملفات مع مدخلات النص المضمّن وعناوين URL لملفات PDF التي تم اختبارها. أعادت طلبات توليد الصور نصًا دون صور، ولم يُكمل بحث الأدوات الاكتشاف على جانب الخادم. لم يُتحقق من إتاحة هذه الإمكانات. يتطلب بحث Collections أيضًا مورد collection صالحًا ولم يُتحقق منه.
يتجاهل Chat الحقول frequency_penalty وpresence_penalty وlogit_bias وstop وlogprobs وtop_logprobs. ويتجاهل Responses الحقول background وcontext_management وmetadata وtruncation وlogprobs وtop_logprobs. لا تُمرر هذه الحقول ولا تُعرض كعناصر تحكم فعالة.
الأخطاء
يعيد الطلب غير الصالح خطأً بدلًا من إجابة مكتملة. تحقّق من قيم الحقول ومرجع الأخطاء العام. لا تُفرض رسوم على الطلبات التي تعيد خطأً.