الانتقال إلى المحتوى الرئيسي
POST
إنشاء إكمال للمحادثة

استخدم أدوات الخادم

أضف أداة phaseo: إلى tools بجانب أدوات الدوال الخاصة بك، وسيشغّلها Phaseo عندما يستدعيها النموذج. تقبل /v1/chat/completions كل أدوات الخادم باستثناء phaseo:apply_patch؛ ويسردها دليل أدوات الخادم.
يُحتسب كل استدعاء لأداة خادم في usage.server_tool_use:
تضيف phaseo:web_search الحقول web_search_requests وweb_search_results وweb_search_extra_results؛ وتضيف phaseo:web_fetch الحقل web_fetch_requests. ولا يزال النوع الأقدم gateway:datetime يعمل. مع stream: true، يشغّل Phaseo أدوار الأدوات بنفسه، ثم يبث إليك الإجابة المستكملة في بث واحد.

الاستدلال في حلقات الأدوات

تُرجع نماذج الاستدلال استدلالها في رسالة المساعد ضمن حقلين:
  • reasoning_content: نص الاستدلال، إن أعاد المزوّد أيًا منه.
  • reasoning_details: مصفوفة من كتل الاستدلال. لكل إدخال type قيمته reasoning.text أو reasoning.summary أو reasoning.encrypted، وindex، وformat يسمّي عائلة المزوّد، مثل anthropic-claude-v1 أو google-gemini-v1.
قد تحمل الإدخالات حالة خاصة بالمزوّد يحتاجها النموذج في الخطوة التالية من حلقة الأدوات: عند البث، يصل فرق reasoning_details بمجرد اكتمال كل كتلة استدلال.
أعد إرسال كل رسالة مساعد مع reasoning_details دون تغيير، في كل طلب، وليس في حلقات الأدوات فقط. لا تُسقط الإدخالات أو تعدّلها أو تغيّر ترتيبها أبدًا، سواء كانت مشفّرة أم لا، بما في ذلك الإدخالات التي لا تحتوي على نص.
قيم signature وdata معتمة، وتسجّل المزوّد والنموذج اللذين أنتجاها. لا يرسلها Phaseo إلا إلى عائلة المزوّد تلك والنموذج نفسه، لذا فإن الرجوع إلى مزوّد آخر يُسقطها بدلًا من أن يفشل. ومن دونها، تشغّل نماذج Claude في وضع التفكير اليدوي الخطوة التالية من حلقة الأدوات بلا تفكير، ويؤدي تغيير reasoning_effort إلى إعادة تشغيل ذاكرة Claude المؤقتة للموجّهات؛ راجع غيّر جهد الاستدلال في منتصف المحادثة.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

application/json

يُعامَل أي حقل اختياري في المستوى الأعلى يُرسَل بالقيمة null على أنه غير مضبوط، تمامًا كما لو حُذف.

model
string
مطلوب
messages
object[]
مطلوب
Minimum array length: 1
models
string[]

نماذج احتياطية اختيارية ومرتبة تُجرَّب بعد model. الحقل model مطلوب وهو دائمًا النموذج الأساسي. عندما تفشل محاولة بالرمز 429 أو 500 أو 502 أو 503 أو 504، تُجرَّب الإدخالة التالية؛ وتُعاد الأخطاء الأخرى دون تغيير. يقبل ما يصل إلى 25 معرّف نموذج أو إعدادًا مسبقًا؛ وتُتجاهل الإدخالات المكررة والإدخالات المطابقة لـ model. يُتحقق من كل محاولة وتُسجَّل وتُحتسب تكلفتها كطلب مستقل، ويعرض الحقل model في الاستجابة وتتبّع التوجيه النموذج الذي خدم الطلب. لا تنتقل طلبات البث إلى نموذج احتياطي إلا قبل إرسال البايت الأول، ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال. ترفض طلبات batch وrealtime وcouncil الحقل models. تكون الأولوية للنماذج الاحتياطية المحددة في مسار ديناميكي، ولا يمكن الجمع بين phaseo/auto وmodels.

Required array length: 1 - 25 elements
Minimum string length: 1
مثال:
prompt
object

يملأ قالب الموجّه المحفوظ في إعداد مسبق. اترك model أو اضبطه على المرجع نفسه، وأرسل محادثة فارغة أو الأدوار التي تُضاف بعد القالب.

reasoning
object
reasoning_effort
enum<string>

اسم مستعار متوافق مع OpenAI للخاصية reasoning.effort.

الخيارات المتاحة:
none,
instant,
minimal,
low,
medium,
high,
xhigh,
max
frequency_penalty
number
النطاق المطلوب: -2 <= x <= 2
logit_bias
object
max_completion_tokens
integer
النطاق المطلوب: x >= 1
max_tokens
integer
النطاق المطلوب: x >= 1
metadata
object
session_id
string

معرّف فريد لتجميع الطلبات المرتبطة (مثل محادثة أو سير عمل وكيل) لأغراض قابلية المراقبة.

Maximum string length: 256
presence_penalty
number
النطاق المطلوب: -2 <= x <= 2
seed
integer
النطاق المطلوب: -9223372036854776000 <= x <= 9223372036854776000
store
boolean
stream
boolean
افتراضي:false
stream_options
object
temperature
number
افتراضي:1
النطاق المطلوب: 0 <= x <= 2
tools
object[]

تعريفات الأدوات لاستدعاءات وظائف النماذج وأدوات خادم البوابة. تشمل أدوات الخادم المدمجة التاريخ والوقت والبحث في الويب وجلب الصفحات وAdvisor وSubagent وFusion والبحث عن النماذج وإنشاء الصور وإنشاء الرقع.

max_tool_calls
integer
النطاق المطلوب: x >= 1
parallel_tool_calls
boolean
افتراضي:true
tool_choice

استراتيجية اختيار الأدوات. تُقبل أنواع أدوات خادم Phaseo وتُحوّل إلى أهداف وظائف أو أدوات لدى المزوّد upstream. يُرسل كائن allowed_tools كما هو إلى OpenAI مع جميع الأدوات. ولا يتلقى المزوّدون الآخرون إلا الأدوات المسموح بها ووضعه (auto أو required)، أو استدعاءً إلزاميًا للأداة عندما يسمح required بأداة واحدة فقط. إذا أدرج allowed_tools أداة لا تعرّفها tools، فلا يمكن إلا لـ OpenAI معالجة الطلب؛ وإلا يُعاد خطأ 400.

الخيارات المتاحة:
auto,
none,
required,
phaseo:datetime,
phaseo:web_search,
phaseo:web_fetch,
phaseo:subagent,
phaseo:fusion,
phaseo:search_models,
gateway:datetime,
gateway:web_search,
gateway:web_fetch
plugins
object[]

إضافات البوابة لهذا الطلب. تضيف web البحث على الويب وتضيف web-fetch قراءة الصفحات إلى أي نموذج، وتصلح response-healing ملفات JSON المشوّهة في الاستجابات المنظّمة غير المتدفقة. تُدمج الإعدادات الافتراضية لمساحة العمل والإعداد المسبق مع هذه القائمة. يعيد معرّف إضافة غير معروف الخطأ 400 unknown_gateway_plugin.

تضيف أداة الخادم phaseo:web_search إلى الطلب، ليتمكن أي نموذج من البحث على الويب. يعمل الطلب، وتُحتسب عمليات البحث وتُفوتر، تمامًا كما مع أداة phaseo:web_search. إذا كان الطلب يتضمن أداة بحث على الويب بالفعل، فلا تضيف الإضافة شيئًا. تُتجاهل الخيارات الأخرى.

logprobs
boolean
افتراضي:false
top_logprobs
integer
النطاق المطلوب: 0 <= x <= 20
top_p
number
النطاق المطلوب: 0 <= x <= 1
stop
response_format
modalities
enum<string>[]
الخيارات المتاحة:
text,
image,
audio
image_config
object
usage
boolean
provider

محدد المزوّد. استخدم نصاً لمزوّد واحد أو خيارات توجيه مثل { "only": ["groq"] }.

الخيارات المتاحة:
openai,
anthropic,
google-ai-studio,
gemini,
mistral,
x-ai,
xai,
groq,
together
provider_options
object

خيارات خاصة بالمزوّد، اختيارية.

user_id
string
user
string
include_reasoning
boolean

يُقبل للتوافق. يُعاد الاستدلال كلما أنتجه النموذج (reasoning_content وreasoning_details)، أيًّا كانت قيمة هذا الحقل.

prediction
object

المخرجات المتوقعة، للحصول على استجابات أسرع عندما يكون معظم الرد معروفًا مسبقًا. تُمرَّر إلى نماذج OpenAI وMistral وMoonshot، ويتجاهلها المزوّدون الآخرون.

service_tier
enum<string> | null

يحدد مستوى توجيه أو تسعير مدعومًا. القيمة auto (أو null) لا تطلب مستوى بعينه، ويُوجَّه الطلب ويُفوتر كما لو لم يُضبط الحقل؛ وتُعامَل scale على أنها default، أي المستوى القياسي.

الخيارات المتاحة:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch,
auto,
scale
prompt_cache_key
string | null

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

prompt_cache_retention
enum<string>

مدة الاحتفاظ بذاكرة المطالبات المؤقتة لنماذج OpenAI وAzure OpenAI السابقة لـ GPT-5.6. تتقدّم على provider_options.openai.prompt_cache_retention.

الخيارات المتاحة:
in_memory,
24h
prompt_cache_options
object

وضع ذاكرة المطالبات المؤقتة ومدة صلاحيتها لـ OpenAI وAzure OpenAI بدءًا من GPT-5.6 (ttl 30m، أو 12h في OpenAI) ولـ DeepInfra (ttl 5m أو 1h). يُحذف للمزوّدين الآخرين.

cache_control
object

التحكم في ذاكرة المطالبات المؤقتة. استخدم type ephemeral مع ttl اختياري قيمته 5m أو 1h. ولا ينطبق scope إلا على سياسة تخزين مؤقت لـ Claude على المستوى الأعلى. تخزّن Amazon Bedrock وGoogle Vertex AI نماذج Claude 3.7 Sonnet و3.5 Sonnet و3 Opus مؤقتًا لمدة 5 دقائق فقط؛ وهناك يُحذف ttl، ويُبلَغ عن قيمة 1h المحذوفة في X-Phaseo-Dropped-Params باسم cache_control.ttl.

safety_identifier
string | null
meta
boolean
افتراضي:false
echo_upstream_request
boolean
debug
object

عناصر تحكم تصحيح أخطاء البوابة. لا تُمرر هذه العلامات إلى المزوّد مطلقًا.

الاستجابة

استجابة إكمال المحادثة

id
string
nativeResponseId
string | null
object
string
created
integer
model
string
provider
string
choices
object[]
usage
object
آخر تعديل في ١٢ نوفمبر ٢٠٢٦