GET /v1/models 返回精确 ID 与 mode: live。目录展示或连接检查成功不会自动开通模型。
请求生命周期
1
认证
对
Authorization: Bearer 中的 API Key 取哈希并匹配有效 API Key。已撤销的 API Key 立即返回 401 unauthorized。2
限流
先检查 Key 的 IP 白名单,再检查每分钟次数与并发上限:默认整个工作空间每分钟 120 次、并发 5 个。详见限流。
3
解析模型
model 必须在 API Key 所属空间内处于启用状态,否则返回 404 model_unavailable。4
检查可用性
该模型当前必须可供真实调用,否则返回
503 channel_unavailable。5
计量与记录
真实请求先原子化预留钱包和 Key 预算,再派发一次调用。
有效最终用量按冻结费率结算并释放未用预留;派发后结果不明确时保持待对账,
不自动发起付费重试或退款。
真实预留预算不足时,在联系模型服务方前返回
402。真实模型限制
下文示例为 GPT 5.4 Mini。多数已接入文本模型最多输出 128,000 Token、默认 32,000(Gemini 3.1 Pro Preview 和 Gemini 3.6 Flash 最多 65,536);DeepSeek V4 Pro、GLM 5.3 和 Kimi K3 默认且最多 4,096;GPT 5.4 Mini 默认 64、最多 256。SSE 与推理内容支持按模型检查,不支持自动付费故障切换。gpt-5.4-mini 支持文本/system 消息与 JSON/SSE 响应,默认输出 64、最大 256 Token。
推理强度显式为 none;GPT 5.4 Mini 支持函数工具、JSON object/schema 和无状态 Responses HTTP/SSE,严格工具、图片和采样仍关闭。
物理联合上下文为 400,000 Token,网关分别按请求大小的输入上界(不超过输入硬上限)和请求输出上限预留,
最高预留金额随工作区价格设置变化,不是最终费用。模型详情以
provider-context-ceiling 标明此模式,由模型服务方检查上下文能否放入。
应用自动重试前请阅读用量与计费。
服务地址
API 域名只提供
/v1/* 与 /health,其余路径返回 404。
当前不启用自动付费重试或故障切换。新模型需先完成能力与计费核验,再按工作空间开通。