跳转到主要内容
POST
创建响应

授权

Authorization
string
header
必填

在 OmniRelay 控制台创建的 API Key。所有者确认身份后可在控制台再次查看。

请求头

X-Gateway-Tags
string

本次调用的标签,以逗号分隔的 key=value,例如 client=acme,env=prod。与 API Key 的默认标签合并;同名 key 以请求体 tags 字段为准。X-OmniRelay-Tags 是同一个请求头的旧名,继续接受。

X-Gateway-Metadata
enum<string>

传 enabled 时,响应会附带 gateway_metadata,说明网关为本次调用做出的决定。其他值或不传此头,响应保持不变。X-OmniRelay-Metadata 是同一个请求头的旧名,继续接受。

可用选项:
enabled

请求体

application/json

参数透传:普通扩展字段透传,仍执行鉴权、文本/函数协议及预算结算边界。

model
string
必填
input
必填

文本或显式消息/函数调用历史。仅文本片段,不支持托管工具或已存储响应引用。

Maximum string length: 1048576
instructions
string
Maximum string length: 1048576
max_output_tokens
integer
必填范围: x >= 1
stream
boolean
默认值:false
store
enum<boolean>
默认值:false
可用选项:
false
tools
object[]

仅真实模式且模型支持 tools 时可用。只支持 function 工具;严格工具和 JSON Schema 关键字另需支持。详见模型接入指南。

Required array length: 1 - 64 elements
tool_choice

模型声明 tool_choice 时可使用 auto、none 或 required。指定函数名选择还要求 capabilities.named_tool_choice。

可用选项:
auto,
none,
required
parallel_tool_calls
boolean
text
object
reasoning
object
tags
object

本次调用的标签。与请求头和 Key 默认标签合并后最多 10 个。key 为 1 至 64 个字符,统一存为小写;value 为 1 至 128 个字符。两者只能包含字母、数字和 - _ . : /。以 gateway: 或 omnirelay: 开头的 key 为保留字。tags 不是对象时会被忽略。

示例:

响应

已验证结果,包含已结算用量和费用。

id
string
必填
object
enum<string>
必填
可用选项:
response
status
enum<string>
必填
可用选项:
completed,
incomplete
model
string
必填
output
object[]
必填
usage
object
必填
cost_microusd
integer
必填

按冻结价格、Token 分项、阶梯和折扣计算的已结算费用,单位微美元。整次费用取整后应用折扣,再向上取整。这是最终费用,不是最高预留。

created_at
integer
error
object | null
incomplete_details
object | null
store
enum<boolean>
可用选项:
false