指南
通过一个 OpenAI 兼容接口调用 Claude、GPT、Gemini 和 Grok:接入配置、流式输出、缓存、限流,以及每个模型的实际计费。
- API 错误码:每一个到底在说什么从 401 到 503,哪些值得重试,以及怎么分辨这是网关的错还是上游的错。
- 12 个 Claude model id 怎么挑按顺序回答四个问题——通道、上下文、价格、能力——12 个 Claude id 就收敛成一份短名单。实付输入价从 0.30 到 4.00 美元每百万。
- 怎么挑写代码的模型:这是一套筛法,不是一份排名四条产品线、27 个文本模型,输入单价从每百万 0.050 美元到 4.00 美元。四道约束就能把它收成一份下午就测得完的候选名单。
- 五个 Gemini 模型怎么选这里的每个 Gemini id 都是 1,000,000 token context、同样的能力、同样的路由。输入价从每百万 0.050 到 0.20 美元——4 倍差距,其余全都一样。
- 六个 Grok 模型怎么选三个文本 id、两个图像 id、一个视频 id,分属三个路由,倍率统一是 0.2 倍。它们的区别在哪,各自该出现在什么决策里。
- 八个 OpenAI id 怎么挑八个里有两个在比价之前就被路由和模态排除了。剩下六个的差异在上下文、输出上限,以及跨度 8.33 倍的单价。按什么顺序决定。
- Claude 的 100 万 token 上下文:什么时候真用得上这里 12 个 Claude id 中有 9 个是 100 万 token 上下文。它买到了什么、装满一次要多少钱,以及什么时候小窗口根本不是瓶颈。
- Claude 扩展思考:什么时候这些 token 花得值12 个 Claude id 里有 11 个支持 thinking。思考预算花的是生成 token,上限就是模型的输出上限——所以真正决定值不值的是输出单价。
- 跑之前先把账算出来消费者价 = 官方每 token 单价 × 该模型的倍率。有两类例外:图像按张收费,视频按秒收费。
- GPT 6 Astra Stable:105 万 token,走的却是 Anthropic 形状的路由目录里最大的上下文,105 万 token;官方 10 / 50 美元定价按 0.2 倍率结算;也是唯一一个走 /v1/messages 而不是 /v1/responses 的 OpenAI id。
- GPT Image 2 接入指南:怎么调用、怎么算钱gpt-image-2 是 0.1 倍率:输入每百万 token $0.50,输出 $3.00。它是唯一按 token 计费的图像 id,成本随尺寸和质量变化。
- Grok 的 500K context,和 1M token 的模型怎么比grok-4.6 和 grok-4.5 是 500,000 token,Claude Sonnet 5 和 Gemini Flash 系列是 1,000,000。多出来的那一半什么时候有用、要花多少钱,以及为什么窗口更大不等于答案更好。
- Grok Imagine Video 1.5:按秒计费的视频生成grok-imagine-video-1.5 是 0.2 倍率,按生成的秒数计费而不是按 token。8 秒 720p 的片子是 0.224 美元。调用是异步的:创建、轮询、下载。
- 定价是怎么算的:倍率如何变成你的账单你的价格 = 官方每 token 单价 × 该模型的倍率。倍率从 0.1 倍到 0.5 倍都有,所以光看倍率永远判断不出谁更便宜。
- OpenAI 兼容 API 接入:发出第一个请求一个 base URL、一把 key、三种请求格式。走哪个端点由模型决定,不是你在配置里选的。
- /v1/responses 路由:它是什么,哪些 id 走它这里八个 OpenAI id 中有六个走 POST /v1/responses、用 Bearer 认证,另外两个不是。路由是怎么定的,换模型时又该注意什么。
- 提示词缓存:把重复前缀的钱省下来cache read 与 cache write 是独立的计费桶,各有各的单价。所以省下的是真的,写进去时付的那笔也是真的。
- 速率限制与配额:这里到底卡在哪没有 RPM 档位,也没有 TPM 上限。真正卡住你的是余额、单 key 配额,以及两个 model id 上的并发限制。
- 读懂 stable 通道:stable-* 买到什么、代价是什么stable-* 是通往同一个上游模型的专属通道,走我们自己的 key,而不是共享账号池。Claude 上倍率是四倍,且不参与账号池故障转移。
- 三种路径形态下的流式响应三条路都用 stream: true,各自的事件格式不同。首字节之前网关做了什么,以及为什么中途 abort 不等于不付钱。
- 从 Anthropic 官方切过来:迁移 SDK/v1/messages、x-api-key、anthropic-version 都不变。变的是 model id,外加一条关于退役 id 的规则。
- 从 OpenAI 官方切过来:迁移已有的集成base URL、key、model id 三处改动。哪些原样能用、哪些要复查,以及怎么确认真的切过去了。