文档

API 接入、密钥、计费、用量与错误码的使用文档。

• 入门

  从注册到第一次调用：平台简介、快速开始、鉴权方式，以及模型 ID、供应商标识与报价标识的用法。

• 简介

  一把密钥调用 OpenAI、Anthropic、Gemini 三种兼容协议的模型，同一模型多家供应商报价，默认选最便宜的合格报价。

• 快速开始

  注册、验证邮箱、创建 API 密钥，用 OpenAI、Anthropic 或 Gemini 兼容接口发出第一次模型调用的完整步骤与示例代码。

• 鉴权

  三种兼容协议的 API 密钥写法：Bearer、x-api-key、x-goog-api-key 与查询参数 key，以及鉴权失败的错误码。

• 模型与标识

  模型 ID、别名、供应商标识与以 route_ 开头的报价标识，以及用 /v1/models 和 /api/v1/models 查询模型。

• 密钥管理

  API 密钥的创建、暂停与撤销，完整密钥只显示一次，以及按密钥设置可用模型、每日每月消费上限、IP 白名单和过期时间的方法。

• 模型能力

  模型的文本、视觉、向量、图片、语音和视频能力分别对应哪些接口，模型状态对调用的影响，以及平台不静默替换模型的规则。

• 常用应用

  把 Cherry Studio、Cursor、Dify 等支持 OpenAI 兼容接口的应用接入平台：API 地址、密钥与模型三项配置，以及连不通时的排查步骤。

• 路由

  平台怎么在同一模型的多个供应商报价之间选择：provider 参数、失败切换、默认路由、数据政策与预算。

• 供应商选择

  provider 路由参数的全部字段、请求头写法、按报价标识锁定、校验规则，以及与 OpenRouter 的三处差异。

• 失败切换

  allow_fallbacks 默认为 false：首选报价失败直接返回错误，切换只在同一模型的报价之间进行，不放宽任何约束。

• 默认路由规则

  默认路由规则：按比价价格排序、1% 以内同档均分、X-ModelPortal-Session 会话亲和 5 分钟，以及 sort 的效果。

• 数据政策

  平台、内容审核服务与供应商三方的数据处理地区，报价数据政策声明，data_collection 与 data_regions 只约束供应商一侧。

• 预算与限额

  余额、密钥每日与每月消费上限、限流分档和 provider.max_price 单价上限，以及超出时的错误码。

• 功能

  流式、工具调用、结构化输出、提示缓存、推理控制、Anthropic 与 Gemini 接口和参数映射表。

• 流式输出

  三种协议的流式输出写法、流式用量 include_usage、首字等待与空闲超时，以及中断时怎么计费。

• 工具调用

  OpenAI、Anthropic、Gemini 工具调用写法，只路由到支持工具调用的报价，以及签名 thinking 块的会话绑定。

• 结构化输出

  JSON 模式与 JSON Schema 结构化输出在 OpenAI Chat、Responses 和 Gemini 里的写法，以及报价需要的能力。

• 提示缓存

  Anthropic cache_control 与上游自动缓存，缓存读写计价，不支持缓存的报价不会让请求失败。

• 推理控制

  统一参数 reasoning 与 reasoning_effort、thinking、thinkingConfig 的对应关系、档位换算和推理 tokens 计费。

• Anthropic Messages 接口

  用 Claude Code 和 Anthropic SDK 接入：base URL 填本站根地址、max_tokens 必填、请求头传路由偏好、错误格式。

• Gemini 接口

  用 Google GenAI SDK 或 REST 调用 Gemini 兼容接口：三种鉴权写法、路径里的模型 ID、流式与错误格式。

• 参数映射表

  temperature、top_p、top_k、seed、n、logprobs、max_tokens、工具、结构化输出、推理、缓存与多模态在三种协议间的映射。

• 计费

  预付费计费、尝试与结算、用量与账单明细、退款规则。

• 计费

  预付费计费规则：充值与赠送额度的扣费顺序、按 tokens、张数和秒数计价、价格版本锁定、失败不收费，以及余额不足和欠费的处理。

• 尝试与结算

  一次请求的尝试怎么计费：只为成功的尝试付费，失败不收费也不向供应商结算，余额预留与释放。

• 用量查看

  在控制台查看请求数、失败率、消费与节省金额，按模型和密钥拆分用量，查询与导出账单明细，以及统计时区和隐私说明。

• 退款

  退款只退还未消费的充值金额，赠送额度不退，申请需要输入登录密码并经财务审核。

• 帮助

  常见问题、错误码表、状态页与隐私说明。

• 常见问题

  接入地址、模型列表为空、失败是否收费、余额够却 402、指定供应商与会话保持等常见问题。

• 常见错误

  OpenAI、Anthropic、Gemini 兼容接口的错误格式，invalid_api_key、insufficient_balance、rate_limited、model_not_found 等常见错误码的原因与处理。

• 状态页

  状态页的可用率、首字延迟和吞吐从哪里来，每 5 分钟一次的探测，以及故障与维护公告。

• 隐私

  平台不保存请求和响应内容（风控审核除外），转发前删除用户关联字段，供应商数据处理以报价声明为准。

• 接口参考

  OpenAI、Anthropic、Gemini 兼容接口与模型列表接口的地址、鉴权、请求字段、响应示例与错误码。

• 概览

  三种协议的基础地址与版本、鉴权、平台请求头 X-ModelPortal-Provider-Preferences 与 X-ModelPortal-Session、错误和限流。

• OpenAI 兼容接口

  /v1/chat/completions、/v1/responses、/v1/embeddings 与 /v1/models 的请求字段、响应示例与错误码。

• Anthropic 兼容接口

  /v1/messages 与 /v1/messages/count_tokens 的请求字段、计费用量、错误类型与 x-should-retry。

• Gemini 兼容接口

  generateContent、streamGenerateContent、countTokens、embedContent 的请求字段、计费用量与错误状态。

• 模型列表接口

  /v1/models 与平台扩展格式 /api/v1/models：查询参数、报价标识、供应商标识、配置声明与数据政策字段。