Skip to main content
POST
إنشاء إكمال للمحادثة

أدوات الخادم

تدعم /v1/chat/completions أدوات الدوال العادية وأدوات الخادم التالية التي يديرها Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation

مثال التاريخ والوقت

عند استخدام أداة خادم، تتضمن بيانات الاستخدام ما يلي:
تضيف phaseo:web_search الحقول server_tool_use.web_search_requests وserver_tool_use.web_search_results وserver_tool_use.web_search_extra_results. وتضيف phaseo:web_fetch الحقل server_tool_use.web_fetch_requests.

ملاحظة حول البث

يدعم stream: true أيضًا. وبالنسبة إلى أدوات الخادم التي يديرها Gateway، قد يعالج Phaseo دور استدعاء الأداة لدى المزوّد، ثم يواصل الحلقة ويعيد إصدار تدفق اصطناعي.

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json
model
string
مطلوب
messages
object[]
مطلوب
Minimum array length: 1
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.

الخيارات المتاحة:
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
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
service_tier
enum<string>
الخيارات المتاحة:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
prompt_cache_key
string | null
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
آخر تعديل في ٢ أكتوبر ٢٠٢٦