OpenAI 兼容 API 返回格式:字段结构与 response_format 支持对比
OpenAI 兼容接口的 chat completion 返回什么、哪些字段靠得住,以及 json_object 与 json_schema 在 OpenAI、Claude、Gemini、DeepSeek、vLLM、Ollama 上的支持差异。
ROIBest AI 的接入教程与用量说明。API 地址统一为 https://ai.roibest.com。
把 Claude Code 指向 ROIBest AI 只需要改两个环境变量。真正会绊住人的是密钥的协议分组选错,以及 ANTHROPIC_BASE_URL 多写了 /v1——先用 curl 验证一次能把两个问题都挡在前面。
OpenAI 兼容接口的 chat completion 返回什么、哪些字段靠得住,以及 json_object 与 json_schema 在 OpenAI、Claude、Gemini、DeepSeek、vLLM、Ollama 上的支持差异。
OpenAI 官方不发免费 Key,但 Gemini 免费层、OpenRouter :free 模型、Groq 免费层和本地 Ollama 都能免费调用 OpenAI 兼容接口。一文看清 base URL、限额与数据条款。
一文看清 Claude 各版本:当前 Fable 5.2、Opus 5.5、Sonnet 5.5、Haiku 5.5 的 API ID 与价格,仍可调用的老版本,以及 Claude 1 到 Sonnet 4.5 的退役时间表。
OpenAI API 支持的文件类型因接口而异:Responses 的 input_file 可传多种文档,Chat Completions 只接受 PDF,File Search、图片和音频也各有清单。上传前先核对接口。
在 OpenAI 兼容 API 上开启 thinking,官方用 reasoning_effort,vLLM/Qwen 则把 enable_thinking 放进 extra_body。本文说明正确写法、如何关闭,以及怎样验证推理过程。
修复 api error: 400 messages.1: system content must contain at least one block——省略空 system,或至少发送一个非空 text block。
从安装登录到第一次安全的仓库任务的 Claude Code 使用教程,并链到代理、MCP 与模型配置深文。
大模型api聚合平台把多家模型的密钥、路由和计量收成一个平面。上线前核实别名、数据路径和多出的一跳。
claude 模型命名要把 Haiku/Sonnet/Opus 昵称和真正计费路由的 API id 分开。生产钉 id,昵称给人看。
四档 Claude 模型怎么选:Haiku 跑大批量,Sonnet 做日常主力,Opus 5.5 是编码代理默认,Fable 5.1 留给最难任务。附精确模型 ID、上下文窗口、价格梯度与降级策略。
Claude Code MCP 配置怎么写:stdio 与 HTTP server 的 .mcp.json 格式、local/project/user 三种作用域、环境变量展开、claude mcp add 用法,以及 server 加载不出来时怎么排查。
LLM 网关 vs OpenRouter 归根到底是归属问题:一个托管账户接很多模型,还是自建网关接直连厂商账户。本文对比 Key 与计费、数据路径和运维。
Anthropic SDK Go 版是 Claude API 的官方 Go 客户端。本文讲清安装、第一个请求、流式输出、错误处理,以及 Base URL 与重试配置。
Anthropic Python SDK 实战入门:安装、客户端与 API Key、首个 messages.create 调用、流式、异步、工具调用,以及 base_url 接中转端点。
从安装 @anthropic-ai/sdk、构造客户端与密钥管理,到 content block、流式输出、工具调用、错误类、重试超时与 baseURL。
Claude Code 设置模型的四种方式、冲突时谁生效、别名与完整 ID 的区别,以及如何确认到底是哪个模型在回答。
Claude Desktop 没有代理设置页。本文讲它如何读取系统代理、如何用启动参数强制指定代理,以及为什么 MCP server 要单独设变量。
Claude Code 的配置文件在哪:用户、项目、本地三级 settings.json,各系统的 managed-settings.json 路径,~/.claude.json、.mcp.json、CLAUDE.md 与登录凭据的位置,以及怎么确认哪个文件在生效。
Claude API 或 Claude Code 报「The operation timed out」,是请求在拿到响应前就到了超时时限。本文讲清它与 504、529、流中断的区别,以及该先调哪些超时设置。
Claude API 返回 529 overloaded_error 意味着服务在所有用户层面满载。本文讲清它和 429、500 的区别、SDK 默认怎么重试,以及退避与换模型兜底的写法。
搜「Claude 镜像站」的人要的其实是两种东西:一个能在浏览器里直接聊天的网页,和一个能填进 Claude Code 或代码里的接口地址。这篇拆清两者的差别、各自的能力边界、判断端点是否可靠的四类信号,以及什么时候该直连官方 API。
一个能跑通的 Claude API curl 示例,就是向 /v1/messages 发一次带三个请求头和 JSON 请求体的 POST。本文给出流式、图片、工具、token 计数、列出模型与排错的可复制命令,均依据 Anthropic 官方文档。
用 OpenAI SDK 调用 Claude 只需改 base_url、Key 和模型名。本文按 Anthropic 官方文档梳理兼容层的配置、生效与被静默忽略的参数,以及 Claude 5 上思考参数的 400 坑。
怎么把 LiteLLM 指向 Claude:SDK 与 proxy 的分工、三条后端路径各自要配什么、哪些 OpenAI 参数能干净翻译哪些不能、流式与工具调用的两个坑,以及一张「现象→原因」的报错对照表。
VS Code 里的 OAI Compatible Provider 已废弃,取而代之的是 Custom Endpoint:三种 API 类型、一个新的 JSON 配置文件,以及一个让多数人配置失败的 url 约定。
「Claude Code 代理」其实指两件事:用 ANTHROPIC_BASE_URL 加凭据配置的 LLM 网关,和用 HTTPS_PROXY 配置的企业 HTTP 代理。本文给出各自的准确变量、该写进哪一层,以及怎么用 /status 确认到底哪条生效。
Claude API 返回 400,说明 Key 没问题、请求体被拒。按排查顺序拆解九个成因:预填充、采样参数、thinking、工具结果配对、图片与协议转换。
在 Anthropic 体系里,OAuth 是 Claude Code 等原生应用使用的 Claude 账号登录方式。本文讲清它与 Console API Key 的区别、claude setup-token 生成的长期令牌,以及官方条款对第三方工具的规定。
base URL 就是 SDK 会在其后拼上 /chat/completions 的那一段——通常是服务商主机加 /v1、结尾不带斜杠。四种典型填错方式、各类客户端分别期望什么、一条 curl 完成验证,以及一张从报错反推病因的对照表。
「OpenAI 兼容」描述的是请求与响应的形状,并不表示你发的每个参数都会被执行。本文拆解兼容性会裂开的四层、最常被静默丢掉的参数、流式与工具调用上会真正打挂客户端的差异,以及一个能直接告诉你问题在第几层的配对请求定位法。
两套机制对两件事:output_config.format 约束响应,工具定义上的 strict 约束工具参数。prefill 技巧为什么现在返回 400、强制 tool_choice 为什么不能用了,以及为什么工具入参必须解析而不是匹配。
上下文窗口是单次请求的输入总量,不是记忆——而且 Models API 里它叫 max_input_tokens,不叫 context_window。真正占用它的是什么、为什么 agent 循环里工具返回是主导项、它与缓存怎么相互作用,以及什么时候该摘要、什么时候该清除。
五个不同的问题穿着同一件外衣,其中四个跟 key 无关。401、403、404、400、429 各自真正的含义,以及那个让有效 key 看起来被无视的凭据解析顺序。
Batches API 把 Messages API 请求异步跑完,全部 token 按标准价的 50% 计费。决定这套集成成败的三件事:照 24 小时上限设计而不是一小时、按 256 MB 字节上限定批次大小而不是十万条、结果按 custom_id 索引而不是按位置。
配置从环境变量与设置文件两条通道进来,设置文件分四种作用域、按键合并而不是互相替换。哪一层会赢、每层该放什么、MCP 为什么是另一套、以及怎么确认改动真的生效。
Claude API 怎么用的完整第一公里:调用前要准备什么、一个 Messages 请求的每部分负责什么、返回值怎么读,以及新手第一个下午最容易踩的四个坑。
响应时间不是一个数字。首字延迟、每秒 token 数、总完成时间三者性质不同、对应的解法也不同,却经常被混为一谈。本文讲清各自由什么决定、怎么测才不自欺、以及哪些改动真的有用。
基准评测表会过期。在接入层,这两套 API 的分叉集中在四处:system prompt 放哪、max_tokens 是否必填、消息交替规则、缓存怎么配——外加一条:兼容层会静默丢掉 provider 独有参数。
一份关于 Claude API 流式响应的实用指南:SSE 传输格式、从 message_start 到 message_stop 的完整事件序列、如何按块索引累积增量、工具调用的 JSON 片段为什么必须一次性解析,以及值得处理的失败形态。
Claude Code 对接的是端点不是厂商。base URL 替换的机制、换完之后哪些能力还在、五步验收怎么跑,以及什么情况下换模型反而更贵。
Claude Code 本身没有地区限制,卡点在它背后的 API 账号。解决它有三条路线:官方 Anthropic 账号、协议兼容的第三方端点、自建网关。本文讲清每条路要求什么、适合谁,以及动手前该核实什么。
开源 LLM Gateway 这一侧已经收敛到四个:LiteLLM、Portkey、Envoy AI Gateway,以及 Kong/APISIX 的 AI 插件。本文讲清它们的真实差别、真正决定选型的五个问题,以及自托管到底要付出什么。
OpenAI API 代理把 OpenAI 格式的请求转发到你指定的主机,客户端只改一行 base URL 就能继续工作。本文讲清它解决什么问题、什么时候该用网关而不是代理,以及切生产流量前必须验的五项行为。
claude.ai 订阅不含 API 权限。本文给出完整路径——控制台组织、充值、组织验证、workspace 限定的 key、速率档位——以及云市场和网关两条替代路线各会改变集成里的什么。
LLM API 网关把一个入口、一把凭据放在多个模型服务商前面,负责路由、兜底切换、按密钥配额、用量记账与日志。它与代理、SDK 路由的区别,什么情况下不需要,以及选型前要核的七件事。
OpenAI 兼容 API 复制了 Chat Completions 的请求与响应结构,因此改一个 base URL 就能让现有客户端继续跑。本文讲清兼容面包含哪些端点、兼容通常在哪六处断掉,以及用三条 curl 验证任意端点。
Claude API 中转(中转站/relay)是架在应用与 Anthropic 官方 API 之间的转发服务,解决网络可达、团队统一计费与 OpenAI 兼容接入。这篇讲清原理、取舍与五个选择核对点。
Codex 走 OpenAI 协议,密钥、端点、配置方式和 Claude Code 三样都不一样。要 OpenAI 兼容分组的密钥、base_url 要带 /v1、配置写在 config.toml 而不是环境变量。
官方 SDK 一行都不用改,只换 base URL 和密钥。这里列全了网关暴露的两套协议端点,以及 OpenAI SDK 要带 /v1、Anthropic SDK 不要带这个最常见的 404 来源。
手动配置的问题不在于难,而在于容易抄错。导入功能会按密钥所属的协议分组生成对应配置,把分组匹配和 base URL 该不该带 /v1 这两件最易错的事交给平台。
OpenAI API Key 在 API 平台签发,不是 ChatGPT 套餐的一部分。本文说明如何创建项目密钥、充入预付额度、保存 OPENAI_API_KEY,以及第一次调用失败时怎么读错误码。
LLM API 供应商不是一个市场:模型厂商、云 AI 平台、开源权重推理托管和路由聚合卖的是不同的东西。本文分类说明各自取舍,并给出七项选型核对清单。
Claude Code 价格首先是订阅问题:Pro、Max、Ultra、Team 或 Enterprise。本文把它和 API 按 token 计费分开,说明限额怎么读,以及什么时候才值得升级。
LLM API subscription 是按量调用之上的套餐/承诺包装。把产品席位和 API 分开,钉模型,按负载计量。
Claude API 成本优化从 usage 字段开始:先找出账单里占大头的 token 类别,再用对应手段处理,涵盖 effort、提示词缓存、工具开销、图片与批处理。
中国大陆、香港、澳门都不在 Anthropic 的支持地区清单上,台湾在。本文讲清政策原文怎么写、为什么这是「资格」问题而不是技术问题,以及云厂商路线的地区清单差在哪。
一次讲清 Anthropic 的使用等级阶梯:组织如何被分到 Start、Build、Scale 或 Custom,官方页面上各档的月度消费上限与分模型限额,在 Console 哪里查看自己的等级,以及等级不够用时怎么办。
Anthropic API 账单页在 Console 里,不在 Claude.ai 里。账单和用量两个视图分别回答什么、余额与发票各自在数什么、工作区如何决定你的花费拆分,以及真正影响下月账单的四个设置。
挂牌的每百万 token 费率是价格对比的起点,不是它的实质。输入输出的价差、不可比的分词器、按输出计费的思考 token、值一个数量级的缓存折扣,以及真正决定胜负的那个指标。
提示缓存是前缀匹配,而且失效时不报错。本文讲断点规则、会吞掉短提示的按模型下限、1 小时 TTL 什么时候反而更贵,以及能证明缓存真实存在的那几个 usage 字段。
把轮换当成季度日历仪式,只会制造故障而没多少风险收益。真正有用的做法更窄:把 key 权限切细让轮换变便宜、用重叠窗口而不是一步替换、吊销前用真实流量验证,并把计划外那次轮换的路径演练熟。
请求数、输入 token、输出 token 是三条分别计量的限制。怎么判断是哪一条在卡、每种情况各自怎么修、重试逻辑该怎么写,以及网关会多出哪一层限额。
买 Claude API 卡在支付这一层,跟价格和准入是三件事。真正能走的路径有三条:自持账号、云厂商市场、协议兼容网关。本文讲清卡被拒的四种原因、预付余额的硬截断特性,以及充值前该核什么。
Claude API 与 Anthropic API 价格是同一份表:按每百万 token 计价,输出价是输入价的五倍。本文给出各模型现行价格、prompt 缓存与批处理如何压成本、思考 token 为何按输出计费,以及真正有效的五个降本动作。
控制台按请求逐条记录用量。这份字段说明解释每一列的含义,尤其是「为什么这次比上次贵」该从哪看起——多数波动能用模型、输出长度和缓存命中三项解释。
一个账号可以签发多把 key,每把单独设额度和有效期。这不只是权限管理,而是把「谁花了多少」从一笔糊涂账拆成可读数据最省事的办法。