الانتقال إلى المحتوى الرئيسي
POST
إنشاء رسالة
أرسل حمولة Anthropic Messages API إلى /v1/messages واحصل على استجابة بتنسيق Anthropic، لأي نموذج يوجّه إليه Phaseo. حقول استخدام الأدوات في Anthropic مدعومة، وتتحكم الترويسة X-Phaseo-Strictness في كيفية التعامل مع المعاملات غير المدعومة. اضبط stream: true لتلقي أحداث مرسلة من الخادم بتنسيق Anthropic (message_start وcontent_block_* وmessage_delta وmessage_stop). ويعمل البث أيضًا في حلقات الأدوات.

رسائل النظام في منتصف المحادثة

أضف رسالة role: "system" إلى messages لتعليمة تسري من تلك النقطة في المحادثة. يبقى الحقل system في المستوى الأعلى كما هو، لذا تظل البادئة المخزّنة مؤقتًا تُصاب.
تقبل رسالة النظام سلسلة نصية أو كتلًا نصية. يجب أن تأتي مباشرة بعد دور للمستخدم (أو دور للمساعد ينتهي بنتيجة أداة خادم)، وأن تكون الرسالة الأخيرة أو يتبعها دور للمساعد. تُرجع المواضع الأخرى 400. لا تُدعم clear_at وoutput_config وكتل tool_addition أو tool_removal.

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

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

استخدم بحث الويب الأصلي في Anthropic

عندما يدعم نموذج Anthropic والمزوّد الموجَّه إليهما بحث الويب الأصلي، مرّر تعريف أداة Anthropic مباشرة، مثل type: "web_search_20250305". ويظل توجيه المزوّدين يصفّي حسب دعم web_search_options قبل التنفيذ.

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json

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

model
string
مطلوب
messages
object[]
مطلوب
Minimum array length: 1
max_tokens
integer
مطلوب
النطاق المطلوب: x >= 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 أو اضبطه على المرجع نفسه، وأرسل محادثة فارغة أو الأدوار التي تُضاف بعد القالب.

system
service_tier
enum<string>

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

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

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

tool_choice

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

plugins
object[]

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

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

stream
boolean
metadata
object
session_id
string

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

Maximum string length: 256
reasoning
object
context_management
object

تحرير السياق من Anthropic. يقبل edits استراتيجيات clear_tool_uses_* وclear_thinking_*، ويُرسَل إلى Anthropic مع ترويسة beta الخاصة بها. يشغّل المزوّدون الآخرون الطلب من دونه ويُدرجون context_management في X-Phaseo-Dropped-Params. تعيد تعديلات الضغط (compact_*) الخطأ 400.

user
string

معرّف المستخدم النهائي، كما في Chat Completions. تستلمه نماذج Claude بوصفه metadata.user_id ما لم يُضبط metadata.user_id.

prompt_cache_key
string | null

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

stop_sequences
string[]
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.

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
context_management
object

يظهر عندما يستخدم الطلب context_management وتطبّق Anthropic تعديلًا. يسرد applied_edits كل تعديل مع ما أزاله. وفي التدفقات، يرد في حدث message_delta الأخير.

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