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>

reasoning.effort の OpenAI 互換エイリアスです。

利用可能なオプション:
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[]

モデルの関数呼び出しとゲートウェイのサーバーツールのツール定義です。組み込みサーバーツールには、日付・時刻、Web 検索、Web 取得、Advisor、Subagent、Fusion、モデル検索、画像生成、パッチ作成が含まれます。

max_tool_calls
integer
必須範囲: x >= 1
parallel_tool_calls
boolean
デフォルト:true
tool_choice

ツール選択の方法です。Phaseo サーバーツールのタイプを受け付け、上流の関数またはツールの指定に変換します。

利用可能なオプション:
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
最終更新日 2026年10月2日