Skip to main content
POST
إنشاء رسالة
تقبل /v1/messages أجسام طلبات Anthropic Messages API وتعيد استجابات بتنسيق Anthropic.

البث

اضبط stream: true لتلقي أحداث مرسلة من الخادم بتنسيق Anthropic (message_start وcontent_block_* وmessage_delta وmessage_stop).

ملاحظات

  • حقول استخدام الأدوات الخاصة بـ Anthropic مدعومة.
  • يعمل stream: true أيضًا مع حلقات الأدوات. وبالنسبة إلى أدوات الخادم التي يديرها Gateway، قد يعالج Phaseo الدور لدى المزوّد، ثم يواصل الحلقة ويعيد إصدار تدفق اصطناعي.
  • يُقبل شكل أداة البحث على الويب الأصلي من Anthropic مباشرة ضمن tools أيضًا، مثل type: "web_search_20250305".
  • تتحكم ترويسة X-Phaseo-Strictness في كيفية التعامل مع المعلمات غير المدعومة.

أدوات الخادم

تدعم /v1/messages أيضًا أدوات الخادم التالية التي يديرها Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
يحوّل Phaseo هذه الأدوات إلى تنسيق متوافق مع Anthropic لدى المزوّد، وينفّذها على الخادم، ثم يواصل حلقة الأدوات.

بحث الويب الأصلي للمزوّد

عندما يدعم زوج متوافق من نموذج Anthropic ومزوّده بحث الويب الأصلي، يمكنك تمرير تعريف الأداة الأصلي مباشرة أيضًا:
يظل توجيه المزوّد يتحقق من دعم web_search_options قبل التنفيذ.

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

عند الاستخدام، تسجّل العدادات usage.server_tool_use.* استدعاءات أدوات الخادم.

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json
model
string
مطلوب
messages
object[]
مطلوب
Minimum array length: 1
max_tokens
integer
مطلوب
النطاق المطلوب: x >= 1
system
service_tier
enum<string>

يحدد مستوى توجيه أو تسعير مدعومًا في واجهات API النصية المتوافقة.

الخيارات المتاحة:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
temperature
number
النطاق المطلوب: 0 <= x <= 1
top_p
number
النطاق المطلوب: 0 <= x <= 1
top_k
integer
النطاق المطلوب: x >= 1
tools
object[]

أدوات متوافقة مع Anthropic، بالإضافة إلى أدوات خادم تديرها البوابة.

tool_choice

كائن أو نص لاختيار أداة Anthropic. تُقبل أيضاً أسماء أدوات الخادم التي تديرها البوابة، وتعيد البوابة كتابتها.

stream
boolean
metadata
object
session_id
string

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

Maximum string length: 256
reasoning
object
stop_sequences
string[]
provider_options
object

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

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

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

provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

الاستجابة

استجابة الرسالة

id
string
type
string
role
enum<string>
الخيارات المتاحة:
assistant
model
string
content
object[]
stop_reason
string
stop_sequence
string
usage
object
آخر تعديل في ٢ أكتوبر ٢٠٢٦