मुख्य सामग्री पर जाएं
POST
चैट completion बनाएँ

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

tools में अपने function टूल के साथ एक phaseo: टूल जोड़ें, और जब मॉडल उसे कॉल करता है तो 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 टूल टर्न खुद चलाता है, फिर आगे का उत्तर आपको एक ही स्ट्रीम में भेजता है।

टूल लूप में रीज़निंग

रीज़निंग मॉडल assistant संदेश पर अपनी रीज़निंग दो फ़ील्ड में लौटाते हैं:
  • reasoning_content: रीज़निंग टेक्स्ट, अगर प्रदाता कोई लौटाता है।
  • reasoning_details: रीज़निंग blocks की एक array। हर प्रविष्टि में reasoning.text, reasoning.summary या reasoning.encrypted में से एक type, एक index, और प्रदाता परिवार बताने वाला format होता है, जैसे anthropic-claude-v1 या google-gemini-v1।
प्रविष्टियों में ऐसी प्रदाता स्थिति हो सकती है जिसकी मॉडल को टूल लूप के अगले चरण में ज़रूरत होती है: स्ट्रीमिंग के दौरान, हर रीज़निंग block पूरा होने पर एक reasoning_details delta आता है।
हर assistant संदेश को उसके reasoning_details के साथ बिना बदले हर अनुरोध पर वापस भेजें, सिर्फ़ टूल लूप में नहीं। प्रविष्टियों को कभी न हटाएं, न बदलें, न उनका क्रम बदलें, चाहे वे encrypted हों या नहीं, बिना टेक्स्ट वाली प्रविष्टियों समेत।
signature और data मान अपारदर्शी होते हैं और उन्हें बनाने वाले प्रदाता और मॉडल को दर्ज करते हैं। Phaseo उन्हें सिर्फ़ उसी प्रदाता परिवार और मॉडल को भेजता है, इसलिए किसी दूसरे प्रदाता पर फ़ॉलबैक होने पर वे विफल होने के बजाय हटा दिए जाते हैं। इनके बिना, मैनुअल thinking मोड में Claude मॉडल टूल लूप का अगला चरण बिना thinking के चलाते हैं, और 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 मॉडल ID या प्रीसेट स्वीकार करता है; डुप्लिकेट और 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>

reasoning.effort के लिए OpenAI-संगत alias।

उपलब्ध विकल्प:
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 ठीक करता है। वर्कस्पेस और प्रीसेट के डिफ़ॉल्ट इस सूची के साथ मिलाए जाते हैं। अज्ञात प्लगइन id पर 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

प्रदाता चयनकर्ता। एकल प्रदाता के लिए string या { "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>

GPT-5.6 से पहले के OpenAI और Azure OpenAI मॉडलों के लिए प्रॉम्प्ट कैश प्रतिधारण। provider_options.openai.prompt_cache_retention पर प्राथमिकता पाता है।

उपलब्ध विकल्प:
in_memory,
24h
prompt_cache_options
object

GPT-5.6 और बाद के OpenAI और Azure OpenAI मॉडलों (ttl 30m, या OpenAI पर 12h) तथा DeepInfra (ttl 5m या 1h) के लिए प्रॉम्प्ट कैश मोड और TTL। अन्य प्रदाताओं के लिए हटा दिया जाता है।

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

गेटवे डिबग नियंत्रण। ये फ़्लैग कभी भी प्रदाता को फ़ॉरवर्ड नहीं किए जाते।

प्रतिक्रिया

चैट completion का प्रतिसाद

id
string
nativeResponseId
string | null
object
string
created
integer
model
string
provider
string
choices
object[]
usage
object
अंतिम संशोधन 12 नवंबर 2026