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