الانتقال إلى المحتوى الرئيسي
ابحث عن نوع حقل الطلب وقيمه المقبولة وقيمته الافتراضية في Chat Completions (/v1/chat/completions) وResponses (/v1/responses) وAnthropic Messages (/v1/messages). يظل الدعم متفاوتًا حسب النموذج والمزوّد: يعرض جدول البدء السريع في كل صفحة نموذج المعاملات التي يدعمها مزوّدوه النشطون لكل نقطة نهاية. للحصول على نصائح الضبط، راجع معاملات الاستدلال.

المعاملات غير المدعومة

إذا كان المزوّد الذي يخدم الطلب لا يدعم أحد معاملات أخذ العينات الاختيارية فيه، يُسقط Phaseo ذلك المعامل: فلا يُرسل إلى المزوّد ولا يُرفض الطلب، لذا تظل تعمل العملاء التي ترسل دائمًا القيم الافتراضية لـ OpenAI. يقرّر Phaseo ذلك لكل مزوّد، بالاعتماد أولًا على ملف تعريف المزوّد ثم على معاملات المسار في الفهرس. إذا لم يعلن المسار أي معاملات، يُتخطى فحص الفهرس فقط؛ وتظل المعاملات التي يصنّفها ملف تعريف المزوّد غير مدعومة تُسقط، مثل top_k على Cohere أو stop على Reflection. تُزال أيضًا قيمة ttl البالغة 12h لذاكرة التخزين المؤقت للمطالبات على المسارات التي لا تقبل ذاكرة OpenAI المؤقتة لمدة 12 ساعة، ويُبلَّغ عنها بوصفها prompt_cache_options.ttl أو prompt_cache_breakpoint.ttl؛ راجع التخزين المؤقت للمطالبات. تسرد الاستجابات الناجحة المعاملات المُسقطة التي أرسلها جسم الطلب:
  • في الترويسة X-Phaseo-Dropped-Params، مثل X-Phaseo-Dropped-Params: top_k, min_p؛
  • في meta.routing.dropped_params عندما يضبط الطلب meta: true، مثل [{"param": "top_k", "reason": "unsupported_by_provider"}].
قد يُسقط معامل جاء من إعداد مسبق أو قيمة افتراضية لا من جسم الطلب دون أن يظهر في أي من الموضعين. ومع ذلك يُسجَّل في تشخيصات التوجيه المحفوظة مع الطلب.

اختر النموذج

model

معرّف نموذج Phaseo المراد تشغيله، مثل openai/gpt-6-astra. مطلوب. استخدم المعرّف الظاهر في البدء السريع بصفحة النموذج؛ فهو الخيار الأكثر أمانًا للأتمتة والتكاملات طويلة الأمد. يعمل هنا أيضًا اسم إعداد مسبق مثل @support-triage.

models

نماذج احتياطية تُجرَّب بالترتيب بعد model. يظل model مطلوبًا ويُشغَّل دائمًا أولًا. لا يُجرَّب الإدخال التالي إلا عندما تفشل محاولة بالحالة 429 أو 500 أو 502 أو 503 أو 504. النوع string[] · الإدخالات من 1 إلى 25؛ تُتجاهل الإدخالات المكررة والمساوية لـ model · مثال ["anthropic/claude-sonnet-5.5", "google/gemini-4-argon"]
  • يُتحقق من كل محاولة وتُسجَّل وتُفوتر بوصفها طلبًا مستقلًا. يعرض الحقل model في الاستجابة وتتبع التوجيه النموذج الذي أجاب.
  • لا تنتقل طلبات البث إلى بديل إلا قبل أول بايت؛ ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال.
  • تكون الأولوية للبدائل المكوّنة على مسار ديناميكي مرتبط. تُقبل الإعدادات المسبقة بوصفها إدخالات. لا يمكن دمج phaseo/auto مع models.
  • ترفض طلبات الدفعات والوقت الفعلي وcouncil الحقل models بالحالة 400.
  • تقبل نقاط النهاية متعددة الأجزاء حقول models المكررة، أو حقول models[]، أو مصفوفة JSON واحدة.
راجع البدائل الاحتياطية للنماذج على مستوى الطلب.

stream

يُرجع الإخراج عبر Server-Sent Events أثناء توليده، بدلًا من جسم استجابة واحد. النوع boolean · الافتراضي false استخدمه لواجهات الدردشة والاستجابات الطويلة. اتركه معطّلًا عندما تريد استجابة JSON واحدة أسهل في إعادة المحاولة والتحليل. قد يختلف بث استدعاءات الأدوات والإخراج المنظّم حسب المزوّد. راجع البث.

أخذ العينات

temperature

مدى عشوائية اختيار الـ tokens. تعطي القيم المنخفضة إخراجًا أكثر تحفظًا وقابلية للتكرار؛ وتعطي القيم المرتفعة تنوعًا أكبر لكن باتساق والتزام بالمخطط أقل. النوع number · النطاق 0–2 في Chat Completions وResponses، و0–1 في Messages · الافتراضي قيمة المزوّد (لا يرسل Phaseo شيئًا عند عدم ضبطه) ابدأ بين 0.2 و0.7، وبقيمة منخفضة للاستخراج والتصنيف وJSON. اضبط temperature أو top_p، لا كليهما معًا. قد تجعل درجة حرارة مرتفعة على نموذج مكمَّم بشدة الإخراج غير مستقر.

top_p

أخذ العينات النووي: يختار النموذج من أصغر مجموعة tokens يبلغ مجموع احتمالاتها top_p. تعطي القيم المنخفضة إخراجًا أضيق وأكثر تركيزًا. النوع number · النطاق 0–1 · الافتراضي قيمة المزوّد القيمة 0.9–1.0 مع temperature معتدلة نقطة بداية معقولة.

top_k

يحصر أخذ العينات في k من الـ tokens الأكثر احتمالًا في كل خطوة. تجعل القيم المنخفضة الإخراج أكثر قابلية للتنبؤ. لا يدعمه كل المزوّدين. النوع integer · النطاق -1 أو أكثر في Chat Completions، و0 أو أكثر في Messages · الافتراضي قيمة المزوّد

min_p

يضيّق أخذ العينات باستبعاد الـ tokens التي تقل عن حد أدنى للاحتمال. النوع number · النطاق 0–1 · الافتراضي قيمة المزوّد

frequency_penalty

يعاقب الـ tokens بنسبة عدد مرات ظهورها سابقًا. ارفعه عندما يدور النموذج في حلقة أو يكرر العبارات. النوع number · النطاق -2–2 · الافتراضي قيمة المزوّد، وغالبًا 0

presence_penalty

يعاقب أي token ظهر سابقًا، ما يدفع النموذج نحو موضوعات وصياغات جديدة. النوع number · النطاق -2–2 · الافتراضي قيمة المزوّد، وغالبًا 0

repetition_penalty

عنصر تحكم خاص بالمزوّد لمنع التكرار، منفصل عن العقوبتين السابقتين. يتفاوت أثره الدقيق أكثر حسب المزوّد. النوع number · النطاق أكبر من 0؛ وغالبًا يقبل المزوّدون حتى 2 · الافتراضي قيمة المزوّد

logit_bias

يجعل tokens محددة أكثر أو أقل احتمالًا. المفاتيح معرّفات tokens وفق مُرمِّز النموذج؛ والقيم هي الانحياز المراد إضافته. النوع object (معرّف token إلى رقم) · الافتراضي غير مضبوط

seed

يطلب أخذ عينات ببذرة محددة، لأغراض التصحيح واختبارات الانحدار. لا يُضمن إخراج مطابق عبر المزوّدين أو عند تغيّر بنية المزوّد التحتية. النوع integer · الافتراضي غير مضبوط

طول الإخراج والإيقاف

max_tokens

يحدد سقف tokens الإخراج في Chat Completions، وهو مطلوب في Messages. استخدمه للتحكم في التكلفة وزمن الانتقال؛ فالقيمة الصغيرة جدًا تقطع الإخراج. النوع integer · النطاق 1 أو أكثر (0 أو أكثر في Messages) · الافتراضي قيمة المزوّد في Chat Completions

max_output_tokens

يحدد سقف tokens الإخراج في Responses. الغرض نفسه مثل max_tokens؛ أرسل الاسم الذي تستخدمه نقطة النهاية لديك. النوع integer · النطاق 1 أو أكثر · الافتراضي قيمة المزوّد

max_completion_tokens

يحدد سقف tokens الإخراج في Chat Completions، وهو الاسم الأحدث لدى OpenAI لـ max_tokens. لا تجمع بين الاثنين في طلب واحد. النوع integer · النطاق 1 أو أكثر · الافتراضي قيمة المزوّد

stop

تسلسل واحد أو أكثر ينهي التوليد، مثل نهاية قالب أو علامة بروتوكول. في Messages يكون الحقل stop_sequences ويقبل مصفوفة. النوع string أو string[] · الافتراضي غير مضبوط

احتمالات الـ tokens

logprobs

يُرجع اللوغاريتم الاحتمالي لكل token في الإخراج، لأغراض التقييم والترتيب وتقدير الثقة. النوع boolean · الافتراضي false

top_logprobs

يُرجع الـ tokens البديلة الأكثر احتمالًا في كل موضع، مع لوغاريتماتها الاحتمالية. يتطلب logprobs: true. النوع integer · النطاق 0–20

الأدوات

tools

الأدوات التي يمكن للنموذج استدعاؤها. استخدم مخطط أدوات OpenAI ما لم يذكر مرجع نقطة النهاية غير ذلك؛ إذ تقبل Messages مخطط Anthropic. تعريف أداة لا يجبر النموذج على استدعائها. النوع array · الافتراضي غير مضبوط

tool_choice

ما إذا كان يمكن للنموذج استدعاء الأدوات: none للنص فقط، وauto لترك القرار للنموذج، وrequired لفرض استدعاء، أو كائن يسمّي أداة واحدة. النوع string أو object

parallel_tool_calls

يسمح بعدة استدعاءات أدوات في دور واحد. اضبطه على false عندما يجب أن تعمل أدواتك واحدة تلو الأخرى، مثلًا عندما يكون لها آثار جانبية مرتبة. النوع boolean · الافتراضي قيمة المزوّد (لا يرسل Phaseo شيئًا عند عدم ضبطه)

max_tool_calls

يحدد سقفًا لعدد استدعاءات الأدوات التي يجريها النموذج للطلب. النوع integer · النطاق 1 أو أكثر · الافتراضي غير مضبوط

الإخراج المنظّم

response_format

يطلب نصًا عاديًا، أو JSON، أو إخراجًا يطابق مخطط JSON. تعتمد الأشكال المقبولة على نقطة النهاية والمزوّد. النوع string أو object · الافتراضي قيمة نقطة النهاية والمزوّد

json_schema

مخطط JSON الذي يجب أن يطابقه الإخراج، ويُضبط داخل response_format ({"type": "json_schema", "json_schema": {...}}). اجعل المخططات ضيقة وخاصة بالمهمة لالتزام أفضل. النوع object

structured_outputs

ليس حقل طلب. في صفحة النموذج، يميّز نقاط النهاية التي يدعم مزوّدوها النشطون الإخراج المقيّد بمخطط. اطلبه باستخدام response_format.

الاستدلال

reasoning

يضبط الاستدلال في النماذج التي تدعمه. تُبقي الحقول غير المضبوطة القيمة الافتراضية للنموذج. يساعد الجهد الأعلى في المسائل الصعبة ويكلّف زمن انتقال وtokens أكثر.

reasoning_effort

الصيغة المختصرة في Chat Completions لـ reasoning.effort. النوع string · القيم none وinstant وminimal وlow وmedium وhigh وxhigh وmax · الافتراضي قيمة النموذج

reasoning_tokens

ليس حقل طلب. في صفحة النموذج، يميّز المسارات التي تُبلغ عن tokens الاستدلال أو تقبل ميزانية استدلال. اضبط الميزانية باستخدام reasoning.max_tokens.

include_reasoning

مقبول في Chat Completions للتوافق، وليس له أي أثر: يُعاد محتوى الاستدلال وملخصاته كلما أنتجها النموذج. قد يكون إخراج الاستدلال كبيرًا، ولا تُرجعه كل النماذج. لتقليله، اخفض reasoning.effort أو اضبط reasoning.enabled على false. النوع boolean

فئة الخدمة والتخزين المؤقت للمطالبات

service_tier

يختار فئة سرعة وسعر في Chat Completions وResponses وMessages، عندما يدعمها النموذج والمزوّد. يربط Phaseo كل قيمة بعنصر التحكم الخاص بالمزوّد. النوع string · الافتراضي standard batch ليست فئة وتُرفض؛ استخدم Batch API. مع حزمة SDK رسمية من Anthropic موجّهة إلى Phaseo، فضّل قيمتي Anthropic ‏auto وstandard_only في /v1/messages؛ أما ultrafast أو priority أو flex أو fast فاستخدم معها HTTP المباشر أو Chat Completions وResponses. راجع فئات الخدمة.

prompt_cache_key

يُبقي الطلبات التي تتشارك بادئة مطالبة، مثل خطوات حلقة وكيل، على المزوّد الذي يحتفظ بذاكرتها المؤقتة. النوع string · الافتراضي غير مضبوط · نقاط النهاية Chat Completions وResponses وMessages يثبّت Phaseo المفتاح على المزوّد والمسار (النشر أو المنطقة) اللذين خدما أول طلب ناجح، ويُبقي الطلبات اللاحقة بالمفتاح نفسه هناك حتى يفشل ذلك المزوّد، أو تنفد حصة Phaseo المُدارة لديه، أو تتوقف سياسة التوجيه لديك عن السماح به. التثبيت خاص بكل مساحة عمل ويستمر ما دامت مدة احتفاظ المزوّد بذاكرته المؤقتة. راجع الارتباط بالمزوّد. يرسل Phaseo إلى المزوّد تجزئة لمعرّف مساحة عملك والمفتاح، لا المفتاح الخام أبدًا، لذا لا تتشارك مساحتا عمل تختاران المفتاح نفسه ذاكرة مؤقتة لدى المزوّد. تعيد الاستجابات المفتاح الذي أرسلته. لا يتلقى الحقلَ المزوّدون الذين ترفضه واجهاتهم، وإرساله لا يستبعد أي مزوّد من التوجيه أبدًا. بدون مفتاح يشتق Phaseo الارتباط من الطلب، لكن المفتاح الصريح يعمل بشكل أفضل في المحادثات الطويلة وجلسات الوكلاء.

prompt_cache_options

وضع ذاكرة التخزين المؤقت للمطالبات ومدتها في OpenAI وAzure OpenAI ‏GPT-5.6 وما بعده (بما في ذلك GPT-6 Astra)، وDeepInfra وMoonshot AI. النوع object · الحقول mode (implicit أو explicit) وttl استخدم {"mode": "explicit", "ttl": "30m"} لتجعل OpenAI تخزّن مؤقتًا نقاط التوقف التي تضعها فقط. تُزال المدة التي لا يقبلها المسار، مثل 12h على Azure OpenAI أو 1h على نموذج Moonshot AI بلا سعر لمدة ساعة، وتُدرج في X-Phaseo-Dropped-Params. لا يتلقى أي مزوّد آخر، ولا نماذج OpenAI السابقة لـ GPT-5.6، الحقل prompt_cache_options؛ إذ تستخدم نماذج OpenAI تلك prompt_cache_retention. يُقبل أيضًا provider_options.openai.prompt_cache_options؛ والقيمة في المستوى الأعلى هي التي تُعتمد.

cache_control

في المستوى الأعلى، يضبط سياسة التخزين المؤقت للمطالبات في Claude. وعلى كتلة محتوى أو تعريف أداة أو نتيجة أداة، يحدد نقطة توقف للتخزين المؤقت. النوع object · الحقول type وttl وscope في المستوى الأعلى. مقبول في Chat Completions وResponses وMessages. ينطبق على Claude لدى Anthropic، وClaude على AWS، وAmazon Bedrock وGoogle Vertex AI: يضع Phaseo حتى أربع نقاط توقف وفقًا لـ scope (all_text أو last_user_message أو agent أو none). يتجاهله المزوّدون الآخرون. provider_options.anthropic.cache_control هو الإعداد نفسه، ويُعتمد عند إرسال الاثنين. على كتلة. يرسل Phaseo نقطة التوقف إلى مسارات Claude وAlibaba Model Studio وVenice، ويحوّلها إلى prompt_cache_breakpoint لـ OpenAI وAzure OpenAI ‏GPT-5.6 وما بعده، ويزيلها لدى المزوّدين الآخرين. يُقبل prompt_cache_breakpoint: {"mode": "explicit"} الخاص بـ OpenAI على الكتل نفسها، ويُعتمد عندما تحمل الكتلة الاثنين. استخدم type: "ephemeral" مع ttl قيمته 5m (الافتراضي) أو 1h. تقبل Anthropic أربع نقاط توقف على الأكثر لكل طلب؛ وعندما تحدد أكثر، يحتفظ Phaseo بالأولى وبآخر ثلاث. راجع التخزين المؤقت للمطالبات.

prompt_cache_retention

مدة الاحتفاظ بذاكرة التخزين المؤقت للمطالبات في نماذج OpenAI وAzure OpenAI السابقة لـ GPT-5.6. النوع string · القيم in_memory و24h لا يرسله Phaseo إلا إلى تلك النماذج، ولا تقبل 24h إلا النماذج التي تدرجها OpenAI. يستخدم GPT-5.6 وما بعده prompt_cache_options.ttl، ولا يتلقى المزوّدون الآخرون الحقل. يُقبل أيضًا provider_options.openai.prompt_cache_retention؛ والقيمة في المستوى الأعلى هي التي تُعتمد.

إعدادات التوجيه والمزوّد

provider

يحدد المزوّدين الذين يمكنهم خدمة الطلب وكيفية ترتيبهم. يُقبل routing بوصفه اسمًا مستعارًا. راجع التوجيه والبدائل الاحتياطية. تتجاهل مطابقة quantizations حالة الأحرف والمسافات والشرطات والشرطات السفلية، وتعامل الأسماء غير الملتبسة بوصفها أسماء مستعارة، مثل float8 وFP8، أو bfloat16 وBF16. تُستبعد العروض التي لا تملك بيانات تكميم كلما ضُبط المرشّح. إذا لم يطابق أي عرض، يفشل الطلب بخطأ يسرد التكميمات المطلوبة والمتاحة بدلًا من التوجيه إلى متغيّر مختلف.

provider_options

إعدادات أصلية خاصة بالمزوّد يمرّرها Phaseo، مفهرسة حسب المزوّد، بينما يبقى باقي الطلب على المخطط المشترك. النوع object يسمّي google.cached_content ذاكرة Gemini مؤقتة صريحة، ولا يعمل إلا مع بيانات اعتمادك الخاصة: مفتاح Google API على Google AI Studio، أو بيانات اعتماد Vertex AI على Vertex AI. على Vertex AI، يرسل Phaseo الطلب إلى المشروع والموقع الواردين في الاسم الكامل للذاكرة المؤقتة (projects/{project}/locations/{location}/cachedContents/{id})؛ ويستخدم الاسم المختصر project_id وregion من ملف JSON لحساب الخدمة. مع بيانات اعتماد Phaseo يُرجع الطلب 400. يُقبل google.cache_control وgoogle.cache_ttl لكنهما لا يُرسلان إلى Google. فضّل cache_control في المستوى الأعلى لـ Claude، وprompt_cache_options لـ OpenAI ‏GPT-5.6 وما بعده، وprompt_cache_retention لنماذج OpenAI الأقدم. راجع التخزين المؤقت للمطالبات.

إضافات الاستجابة والتصحيح

meta

يضيف إلى الاستجابة كائن meta بتفاصيل التوجيه، مثل meta.routing.dropped_params. النوع boolean · الافتراضي false

usage

يطلب حساب الاستخدام في جسم الاستجابة، بدلًا من الاعتماد على الترويسات أو لوحة التحكم. النوع boolean · الافتراضي غير مضبوط

debug

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

مثال على طلب

آخر تعديل في ٥ نوفمبر ٢٠٢٦