API 概览
顶级AI API family、调用入口和全局约定。
先选 API family/调用入口，再选模型商品
顶级AI按 API family 和原生 wire 调用入口接入和计费。公开 API family/原生 wire 入口包括 OpenAI Chat Completions、OpenAI Responses、Images API 的 Generations operation、Anthropic Messages API 和 Gemini GenerateContent；Images API 的 Edits operation 当前只有网页登录态内部调用入口，Anthropic Messages API 的 Count Tokens 是其具体 operation，不是独立顶级协议。客户端必须按当前调用入口的路径、Header 和请求体发送；网关不会把一种 API/wire family 请求自动转换成另一种。同一 public model id 跨调用入口不会自动可用，必须以对应内部调用入口的模型商品和上游 capability 为准。
这组文档写什么
开发接入文档只描述项目已经实现的公开 API 行为：鉴权方式、请求路径、模型选择、流式响应、usage 计费和错误结构。
OpenAI Responses
OpenAI Responses API family，使用 /v1/responses，按 Responses usage 字段结算。
Codex Search 能力
Responses 场景下由 Codex 按需触发的 Search 传输能力；不新增顶级协议或独立计费。
OpenAI Chat Completions
OpenAI Chat Completions API family，兼容 /v1/chat/completions，也保留 /chat/completions。
Anthropic Messages
Anthropic Messages API family，使用 /v1/messages 或 /anthropic/v1/messages，按 x-api-key 鉴权。
Gemini GenerateContent
Gemini API family 的 GenerateContent operation，使用 /v1beta/models/{model}:generateContent，按 Gemini 原生路径和 usageMetadata 处理。
Images API · Generations
公开的 Images API Generations operation；Images Edits 当前仅为网页登录态内部调用入口，Count Tokens 是 Anthropic Messages API 下的 operation。
最短接入路径
确定客户端要走哪个 API family/调用入口
OpenAI 新项目和 Codex 类工具优先看 Responses；存量 OpenAI-compatible 客户端通常走 Chat Completions；Claude/Anthropic 工具走 Messages；Gemini 原生客户端走 GenerateContent；图片相关 operation 在其他调用入口与操作中。
按调用入口查询或复制模型商品
模型商品使用 public model id 标识。8788 可将同名 public model id 分别发布到多个内部调用入口；同一 ID 跨入口不会自动可用，不能用 A 入口的模型列表证明 B 入口可用。
使用用户 API Key 发起请求
这里的 Key 是顶级AI控制台创建的用户 API Key，不是上游 provider Key。
用 request_id 排查结果
响应头会带 X-Request-Id；OpenAI 和 Gemini 风格错误体也会带 request_id。遇到问题时保留它，比只截图错误文案更容易定位。
全局事实
Prop
Type
最后更新于