Claude API curl 示例：消息、流式、图片与工具调用的可复制请求（2026）
一个能跑通的 Claude API curl 示例，就是向 /v1/messages 发一次带三个请求头和 JSON 请求体的 POST。本文给出流式、图片、工具、token 计数、列出模型与排错的可复制命令，均依据 Anthropic 官方文档。
博客
ROIBest AI 的接入教程与用量说明。API 地址统一为 https://ai.roibest.com。
置顶 · 接入教程
Claude Code 接入 ROIBest AI：三步替换 Base URL
把 Claude Code 指向 ROIBest AI 只需要改两个环境变量。真正会绊住人的是密钥的协议分组选错，以及 ANTHROPIC_BASE_URL 多写了 /v1——先用 curl 验证一次能把两个问题都挡在前面。
接入教程
用 OpenAI SDK 调用 Claude：官方兼容层配置与被忽略的参数（2026）
用 OpenAI SDK 调用 Claude 只需改 base_url、Key 和模型名。本文按 Anthropic 官方文档梳理兼容层的配置、生效与被静默忽略的参数，以及 Claude 5 上思考参数的 400 坑。
LiteLLM 接 Claude：三条路由路径、参数映射与那些像 bug 的坑
怎么把 LiteLLM 指向 Claude：SDK 与 proxy 的分工、三条后端路径各自要配什么、哪些 OpenAI 参数能干净翻译哪些不能、流式与工具调用的两个坑，以及一张「现象→原因」的报错对照表。
VS Code 的 OAI Compatible Provider 去哪了：Custom Endpoint 自定义端点怎么配（2026）
VS Code 里的 OAI Compatible Provider 已废弃，取而代之的是 Custom Endpoint：三种 API 类型、一个新的 JSON 配置文件，以及一个让多数人配置失败的 url 约定。
Claude Code 代理配置：网关中转与企业代理是两回事，各自怎么设
「Claude Code 代理」其实指两件事：用 ANTHROPIC_BASE_URL 加凭据配置的 LLM 网关，和用 HTTPS_PROXY 配置的企业 HTTP 代理。本文给出各自的准确变量、该写进哪一层，以及怎么用 /status 确认到底哪条生效。
Claude API 400 错误怎么排查：invalid_request_error 的九个常见成因
Claude API 返回 400，说明 Key 没问题、请求体被拒。按排查顺序拆解九个成因：预填充、采样参数、thinking、工具结果配对、图片与协议转换。
Anthropic OAuth 是什么：订阅登录、API Key 与第三方工具的使用边界
在 Anthropic 体系里，OAuth 是 Claude Code 等原生应用使用的 Claude 账号登录方式。本文讲清它与 Console API Key 的区别、claude setup-token 生成的长期令牌，以及官方条款对第三方工具的规定。
OpenAI 兼容 Base URL 该填什么：四种典型填错方式与一条验证命令（2026）
base URL 就是 SDK 会在其后拼上 /chat/completions 的那一段——通常是服务商主机加 /v1、结尾不带斜杠。四种典型填错方式、各类客户端分别期望什么、一条 curl 完成验证，以及一张从报错反推病因的对照表。
OpenAI 兼容性问题：「兼容」到底覆盖了什么，边界在哪里，怎么定位
「OpenAI 兼容」描述的是请求与响应的形状，并不表示你发的每个参数都会被执行。本文拆解兼容性会裂开的四层、最常被静默丢掉的参数、流式与工具调用上会真正打挂客户端的差异，以及一个能直接告诉你问题在第几层的配对请求定位法。
Claude API 结构化输出：约束响应、校验工具入参，以及取代 prefill 的做法
两套机制对两件事：output_config.format 约束响应，工具定义上的 strict 约束工具参数。prefill 技巧为什么现在返回 400、强制 tool_choice 为什么不能用了，以及为什么工具入参必须解析而不是匹配。
Claude API 上下文窗口：什么在吃掉它、真实额度怎么读、以及怎么让对话活过它
上下文窗口是单次请求的输入总量，不是记忆——而且 Models API 里它叫 max_input_tokens，不叫 context_window。真正占用它的是什么、为什么 agent 循环里工具返回是主导项、它与缓存怎么相互作用，以及什么时候该摘要、什么时候该清除。
Anthropic API Key 用不了？先读状态码：401/403/404/400/429 各是什么问题
五个不同的问题穿着同一件外衣，其中四个跟 key 无关。401、403、404、400、429 各自真正的含义，以及那个让有效 key 看起来被无视的凭据解析顺序。
Claude API 批处理：五折账单、24 小时上限，和那个会静默错位的坑（2026）
Batches API 把 Messages API 请求异步跑完，全部 token 按标准价的 50% 计费。决定这套集成成败的三件事：照 24 小时上限设计而不是一小时、按 256 MB 字节上限定批次大小而不是十万条、结果按 custom_id 索引而不是按位置。
Claude Code 配置：分几层、怎么合并、凭据该放哪一层
配置从环境变量与设置文件两条通道进来，设置文件分四种作用域、按键合并而不是互相替换。哪一层会赢、每层该放什么、MCP 为什么是另一套、以及怎么确认改动真的生效。
Claude API 怎么用：从拿到 Key 到第一次成功调用（2026）
Claude API 怎么用的完整第一公里：调用前要准备什么、一个 Messages 请求的每部分负责什么、返回值怎么读，以及新手第一个下午最容易踩的四个坑。
LLM API 延迟：真正该看的三个数字，以及怎么把它们测准（2026）
响应时间不是一个数字。首字延迟、每秒 token 数、总完成时间三者性质不同、对应的解法也不同，却经常被混为一谈。本文讲清各自由什么决定、怎么测才不自欺、以及哪些改动真的有用。
Claude vs GPT API：真正影响你接入工作的那些差异（2026）
基准评测表会过期。在接入层，这两套 API 的分叉集中在四处：system prompt 放哪、max_tokens 是否必填、消息交替规则、缓存怎么配——外加一条：兼容层会静默丢掉 provider 独有参数。
Claude API 流式响应：事件序列如何工作，以及怎么正确消费
一份关于 Claude API 流式响应的实用指南：SSE 传输格式、从 message_start 到 message_stop 的完整事件序列、如何按块索引累积增量、工具调用的 JSON 片段为什么必须一次性解析，以及值得处理的失败形态。
Claude Code 换用其他模型：端点替换怎么做、哪些能力会掉
Claude Code 对接的是端点不是厂商。base URL 替换的机制、换完之后哪些能力还在、五步验收怎么跑，以及什么情况下换模型反而更贵。
国内怎么用 Claude Code：三条接入路线与选型指南
Claude Code 本身没有地区限制，卡点在它背后的 API 账号。解决它有三条路线：官方 Anthropic 账号、协议兼容的第三方端点、自建网关。本文讲清每条路要求什么、适合谁，以及动手前该核实什么。
开源 LLM Gateway 怎么选：四个值得进候选名单的项目与五个决策点
开源 LLM Gateway 这一侧已经收敛到四个：LiteLLM、Portkey、Envoy AI Gateway，以及 Kong/APISIX 的 AI 插件。本文讲清它们的真实差别、真正决定选型的五个问题，以及自托管到底要付出什么。
OpenAI API 代理（中转）是什么：作用、切换方法与上线前必验的五件事
OpenAI API 代理把 OpenAI 格式的请求转发到你指定的主机，客户端只改一行 base URL 就能继续工作。本文讲清它解决什么问题、什么时候该用网关而不是代理，以及切生产流量前必须验的五项行为。
Anthropic Claude API 接入权限：官方路线、卡点在哪、两条替代路线（2026）
claude.ai 订阅不含 API 权限。本文给出完整路径——控制台组织、充值、组织验证、workspace 限定的 key、速率档位——以及云市场和网关两条替代路线各会改变集成里的什么。
LLM API 网关是什么：它解决什么问题、什么时候需要、怎么选
LLM API 网关把一个入口、一把凭据放在多个模型服务商前面，负责路由、兜底切换、按密钥配额、用量记账与日志。它与代理、SDK 路由的区别，什么情况下不需要，以及选型前要核的七件事。
什么是 OpenAI 兼容 API？端点、客户端与切换方法
OpenAI 兼容 API 复制了 Chat Completions 的请求与响应结构，因此改一个 base URL 就能让现有客户端继续跑。本文讲清兼容面包含哪些端点、兼容通常在哪六处断掉，以及用三条 curl 验证任意端点。
Claude API 中转是什么？原理、使用场景与选择指南（2026）
Claude API 中转（中转站/relay）是架在应用与 Anthropic 官方 API 之间的转发服务，解决网络可达、团队统一计费与 OpenAI 兼容接入。这篇讲清原理、取舍与五个选择核对点。
Codex 接入 ROIBest AI：OpenAI 兼容协议怎么配
Codex 走 OpenAI 协议，密钥、端点、配置方式和 Claude Code 三样都不一样。要 OpenAI 兼容分组的密钥、base_url 要带 /v1、配置写在 config.toml 而不是环境变量。
用 SDK 和 curl 直接调用 ROIBest AI
官方 SDK 一行都不用改，只换 base URL 和密钥。这里列全了网关暴露的两套协议端点，以及 OpenAI SDK 要带 /v1、Anthropic SDK 不要带这个最常见的 404 来源。
用 CC Switch 一键导入桌面客户端配置
手动配置的问题不在于难，而在于容易抄错。导入功能会按密钥所属的协议分组生成对应配置，把分组匹配和 base URL 该不该带 /v1 这两件最易错的事交给平台。
用量与计费
Claude API 成本优化：先找清 token 花在哪，再选对手段（2026）
Claude API 成本优化从 usage 字段开始：先找出账单里占大头的 token 类别，再用对应手段处理，涵盖 effort、提示词缓存、工具开销、图片与批处理。
Claude 在中国能用吗？Anthropic 支持地区政策到底怎么规定的（2026）
中国大陆、香港、澳门都不在 Anthropic 的支持地区清单上，台湾在。本文讲清政策原文怎么写、为什么这是「资格」问题而不是技术问题，以及云厂商路线的地区清单差在哪。
Anthropic 速率限制等级（Rate Limit Tiers）：怎么分档、怎么升档、每档改变什么（2026）
一次讲清 Anthropic 的使用等级阶梯：组织如何被分到 Start、Build、Scale 或 Custom，官方页面上各档的月度消费上限与分模型限额，在 Console 哪里查看自己的等级，以及等级不够用时怎么办。
Anthropic API 账单页：在哪找、每个数字是什么意思
Anthropic API 账单页在 Console 里，不在 Claude.ai 里。账单和用量两个视图分别回答什么、余额与发票各自在数什么、工作区如何决定你的花费拆分，以及真正影响下月账单的四个设置。
大模型 API 价格对比：一张挂牌费率表漏掉的五个变量
挂牌的每百万 token 费率是价格对比的起点，不是它的实质。输入输出的价差、不可比的分词器、按输出计费的思考 token、值一个数量级的缓存折扣，以及真正决定胜负的那个指标。
Claude API 提示缓存（prompt caching）：断点、TTL 的账，以及它为什么会静默失效
提示缓存是前缀匹配，而且失效时不报错。本文讲断点规则、会吞掉短提示的按模型下限、1 小时 TTL 什么时候反而更贵，以及能证明缓存真实存在的那几个 usage 字段。
API 密钥轮换最佳实践：重叠窗口、权限收窄与泄漏应对（2026）
把轮换当成季度日历仪式，只会制造故障而没多少风险收益。真正有用的做法更窄：把 key 权限切细让轮换变便宜、用重叠窗口而不是一步替换、吊销前用真实流量验证，并把计划外那次轮换的路径演练熟。
Anthropic API 速率限制：三条轴怎么计量、撞上了该怎么修
请求数、输入 token、输出 token 是三条分别计量的限制。怎么判断是哪一条在卡、每种情况各自怎么修、重试逻辑该怎么写，以及网关会多出哪一层限额。
Claude API 购买与充值：三条支付路径、预付余额，以及卡被拒的四种原因
买 Claude API 卡在支付这一层，跟价格和准入是三件事。真正能走的路径有三条：自持账号、云厂商市场、协议兼容网关。本文讲清卡被拒的四种原因、预付余额的硬截断特性，以及充值前该核什么。
Claude API 价格 2026：完整价目表、缓存折扣，以及账单到底被什么推高
Claude API 与 Anthropic API 价格是同一份表：按每百万 token 计价，输出价是输入价的五倍。本文给出各模型现行价格、prompt 缓存与批处理如何压成本、思考 token 为何按输出计费，以及真正有效的五个降本动作。
看懂用量明细：模型、Token、缓存与费用怎么算
控制台按请求逐条记录用量。这份字段说明解释每一列的含义，尤其是「为什么这次比上次贵」该从哪看起——多数波动能用模型、输出长度和缓存命中三项解释。
API Key 的额度与有效期怎么设
一个账号可以签发多把 key，每把单独设额度和有效期。这不只是权限管理，而是把「谁花了多少」从一笔糊涂账拆成可读数据最省事的办法。