मुख्य सामग्री पर जाएं
POST
संदेश बनाएँ
/v1/messages पर Anthropic Messages API पेलोड भेजें और Phaseo द्वारा रूट किए जाने वाले किसी भी मॉडल से Anthropic फ़ॉर्मैट में प्रतिक्रिया पाएं। Anthropic के tool-use फ़ील्ड समर्थित हैं, और X-Phaseo-Strictness हेडर तय करता है कि असमर्थित पैरामीटर के साथ क्या किया जाए। Anthropic फ़ॉर्मैट में server-sent events (message_start, content_block_*, message_delta, message_stop) पाने के लिए stream: true सेट करें। स्ट्रीमिंग टूल लूप में भी काम करती है।

बातचीत के बीच सिस्टम संदेश

बातचीत में किसी खास बिंदु से लागू होने वाले निर्देश के लिए messages में एक role: "system" संदेश जोड़ें। शीर्ष-स्तर का system फ़ील्ड वैसा ही रहता है, इसलिए कैश किया गया प्रीफ़िक्स अब भी हिट होता है।
सिस्टम संदेश एक string या text blocks लेता है। यह किसी user टर्न के ठीक बाद आना चाहिए (या ऐसे assistant टर्न के बाद जो server tool result पर खत्म होता हो), और या तो आखिरी संदेश होना चाहिए या उसके बाद assistant टर्न आना चाहिए। दूसरी जगहों पर 400 लौटता है। clear_at, output_config, और tool_addition या tool_removal blocks समर्थित नहीं हैं।

सर्वर टूल का उपयोग करें

tools में एक phaseo: टूल जोड़ें, और जब मॉडल उसे कॉल करता है तो 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 मॉडल ID या प्रीसेट स्वीकार करता है; डुप्लिकेट और 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 टूल चयन का object या string। गेटवे-प्रबंधित सर्वर टूल नाम भी स्वीकार किए जाते हैं और गेटवे द्वारा बदले जाते हैं।

plugins
object[]

इस अनुरोध के लिए गेटवे प्लगइन। web किसी भी मॉडल में वेब खोज और web-fetch पेज पढ़ना जोड़ता है; response-healing बिना स्ट्रीमिंग वाले स्ट्रक्चर्ड रिस्पॉन्स में खराब JSON ठीक करता है। वर्कस्पेस और प्रीसेट के डिफ़ॉल्ट इस सूची के साथ मिलाए जाते हैं। अज्ञात प्लगइन id पर 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_* रणनीतियाँ दी जा सकती हैं, और इसे उसके beta हेडर के साथ Anthropic को भेजा जाता है। अन्य प्रदाता इसके बिना अनुरोध चलाते हैं और 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 इवेंट में आता है।

अंतिम संशोधन 5 नवंबर 2026