模型协议与参数
本页按“模型 → 协议 → 参数”展示当前市场公开目录的配置。模型名称与调用 ID 不一定相同;免费版和付费版的调用 ID 分开列出。国内、国际市场分别读取各自目录,不能用一侧的结果推定另一侧。
查询当前模型
当前市场:国际 · 不同调用 ID 分别展示,免费状态以目录标记为准;另一市场可能有不同模型与入口。
OpenAI: GPT-6.1 Sol
调用模型 ID:gpt-6.1-sol · 未标记免费
以下入口来自当前公开目录配置;列出入口不代表已完成参数资格验证。最小请求是协议结构示例,不是实调成功回执。
| 协议 | 当前目录 |
|---|---|
| OpenAI Chat Completions | 已声明调用入口 |
| OpenAI Responses | 已声明调用入口 |
| Anthropic Messages | 已声明调用入口 |
OpenAI Chat Completions
POST /v1/chat/completions
未配置或未声明保证参数:无法列出该模型在此协议下的参数承诺。此状态不表示不支持任何参数;请勿从其他模型或供方参数表推导。
无法生成可核验调用地址:当前协议缺少合法的公开 Base URL 或端点,请稍后重试。
OpenAI Responses
POST /v1/responses
未配置或未声明保证参数:无法列出该模型在此协议下的参数承诺。此状态不表示不支持任何参数;请勿从其他模型或供方参数表推导。
无法生成可核验调用地址:当前协议缺少合法的公开 Base URL 或端点,请稍后重试。
Anthropic Messages
POST /v1/messages
未配置或未声明保证参数:无法列出该模型在此协议下的参数承诺。此状态不表示不支持任何参数;请勿从其他模型或供方参数表推导。
无法生成可核验调用地址:当前协议缺少合法的公开 Base URL 或端点,请稍后重试。
参数列表与约束来自当前模型配置,不照搬供方声明。未配置或未声明保证参数表示当前没有可公布的参数承诺,不表示所有参数都不支持。目录中的协议声明也不等于真实渠道已经完成资格验证。请先选模型,再查对应协议;不要把某一模型的参数表套给其他模型。
基础请求字段与结构
以下说明协议结构与用途,不能代替上面的模型参数保证集。能力字段只有在当前入口声明后才构成承诺;未声明固定默认值时,本页不会推定默认值。
| 入口 | 参数 | 类型 / 必填 | 不传时与用途 | 结构与示例 |
|---|---|---|---|---|
| 三个入口 | model | string / 必填 | 指定调用模型,无固定默认值 | 使用上方显示的完整调用 ID;免费后缀也要保留 |
| Chat Completions | messages | array / 必填 | 传入对话历史,无默认历史 | [{"role":"user","content":"Hello"}];文本消息需 role、content |
| Responses | input | string 或 array / 必填 | 输入文本或显式历史,无默认输入 | "Hello" 或 [{"role":"user","content":"Hello"}] |
| Messages | messages | array / 必填 | 传入 user/assistant 对话,无默认历史 | [{"role":"user","content":"Hello"}];系统提示用独立 system |
| Chat / Messages | system 消息或字段 | string / 内容块数组;按入口格式提供 | 不传则不额外添加系统指令;不保证隐藏提示或供方默认 | Chat 放在 messages 的 system 消息;Messages 用 system 字段 |
| Responses | instructions | string;按需 | 本轮指令,不代表保存历史 | "Answer concisely" |
| 三个入口 | stream | boolean;可选 | 未启用时走非流式响应;传 true 请求 SSE | true;流式事件格式仍跟随入口协议 |
| Chat Completions | stream_options | object;可选 | 控制流式用量返回;不是模型生成能力 | {"include_usage":true} |
| Messages | max_tokens | integer;协议请求应显式提供 | 输出上限,单位 token;无统一固定默认,合法范围须看当前保证集 | 仅在当前声明允许时传入如 128,不要从其他模型推导上限 |
Chat 工具通常采用 tools:[{"type":"function","function":{"name":"lookup","parameters":{"type":"object","properties":{}}}}];Responses 使用 tools:[{"type":"function","name":"lookup","parameters":{"type":"object","properties":{}}}];Messages 使用 tools:[{"name":"lookup","input_schema":{"type":"object","properties":{}}}]。它们说明对象形状,不表示当前模型支持工具。工具名、schema 方言、工具个数和子字段限制以当前保证配置为准。
range:[最小值,最大值] 是包含边界的数值区间,null 边界表示该方向未限制;enum 是可选值,const 是固定值,forbid_values 是禁用值,max_items 是数组元素数上限,fields 递归列出对象子字段约束。schema_profile 约束工具 JSON Schema 的形状,ttl 列出缓存允许的 TTL。未配置范围不能解读为无限制,也不能从模型上下文窗口推导输出上限。
参数用途与组合
输出上限字段按入口分别为 Chat 的 max_tokens / max_completion_tokens、Responses 的 max_output_tokens、Messages 的 max_tokens,单位均为 token。temperature 与 top_p 控制采样;reasoning_effort、reasoning、thinking 等控制思考;response_format、text.format、output_config.format 控制结构化输出。具体字段、枚举和范围只以上方当前入口的声明为准,不是所有入口都接受这些字段。
| 规则 | 含义 | 修正方法 |
|---|---|---|
exclusive | params 所列字段不能同时出现 | 保留一个字段,移除其他冲突字段 |
requires | 第一个参数出现时,需要后续全部参数 | 补齐依赖,或移除触发参数 |
fixed_when | when 条件命中时,目标参数必须等于 value | 按当前配置设置固定值,或调整触发条件 |
例如,仅当所选模型明确声明 temperature 范围 [0,1] 时,{"temperature":0.5} 才是该项合法取值示例;如果当前组合还声明了与 top_p 互斥,就不能同时携带 top_p。这是假设配置的读法,不是对任一模型的参数承诺。
参数错误与修正
模型开启强制参数准入后,网关在上游调用前拒绝保证集之外的能力参数及非法约束。未配置、关闭或观察阶段不会自动获得同样的拒绝保证;当前页面没有列出参数时,不能推定这些校验已开启。
| 错误标识 | 含义 | 修正示例 |
|---|---|---|
unsupported_parameter | 参数不在当前模型和协议的保证集内,或平台未提供该能力 | 删除未声明的 seed;只有目标协议声明了该能力时才换用对应入口 |
unsupported_value | 类型错误、数值越界、非法枚举、对象或数组不符合约束 | 若当前范围为 [0,1],把 temperature:2 改为 0.5;枚举从当前表中选择 |
invalid_parameter_combination | 违反互斥、依赖或条件固定值 | 若声明 parallel_tool_calls requires tools,则补齐合法 tools,或移除 parallel_tool_calls |
Chat 与 Responses 返回 HTTP 400 的 OpenAI 形态,error.type 为 invalid_request_error,error.code 为上述错误标识,并用 error.param 指向首个问题字段。Messages 返回 HTTP 400 的 Anthropic error 形态,类型为 invalid_request_error,参数诊断保留在错误消息中;不要假设它拥有 OpenAI 的 error.code 字段。多个问题可能一起被记录,先修正返回指出的问题再重试。
Responses 能力边界
Responses 入口声明不代表平台提供全部服务端状态功能。previous_response_id 的历史补全依赖账户范围内的临时历史缓存(当前实现 TTL 为 24 小时),不是永久会话存储;取不到历史且 input 没有先前对话时会返回 400,应改为在 input 显式携带完整历史。建议始终显式保存并发送应用所需历史,不依赖临时缓存的可用性。
强制参数准入下,background、conversation、prompt 与托管工具(如 web_search、file_search、computer_use)不作为已提供能力接受。store、include 在该参数准入词表中属于接受但不保证透传的忽略项,不能据此推导服务端存储、检索、后台任务或取消能力。GET /v1/responses/{id} 与取消接口未在本页列为可用入口。未配置模型仍可能保留旧处理行为,不能把“未报错”视为能力已生效。
缓存字段与用量
缓存标记只有在当前模型和入口声明对应能力时才可作为承诺使用。cache_control 的对象形状示例为 {"type":"ephemeral","ttl":"5m"};5m 是 5 分钟,1h 是 1 小时,允许值仍由当前配置决定。缓存读写是否发生、TTL 与费用取决于实际响应及价格配置,不能从参数被接受推定命中。
| 入口 | 协议常见用量字段 | ModelGo 扩展与注意事项 |
|---|---|---|
| Chat Completions | usage.prompt_tokens_details.cached_tokens | cached_creation_tokens 是 ModelGo 兼容扩展,不能当成所有 OpenAI 客户端都支持的标准字段 |
| Responses | usage.input_tokens_details.cached_tokens | 不从缺省字段推定零缓存 |
| Messages | usage.cache_read_input_tokens、usage.cache_creation_input_tokens | 写入总数与按 5m / 1h 拆分字段不能重复累加 |
上游未报告缓存用量与真实报告 0 是不同状态。当前未开启新版输出的模型可能沿用旧的零值/缺省行为,因此单凭一个 0 或缺省字段无法证明“上游已报告零缓存”;需结合可见调用日志和账单核验。新版输出按模型开启,不把其他模型的行为套到当前模型。