外观
接入地址与模型
接入失败时，先看客户端最终请求了哪个地址。最常见的问题是遗漏或重复拼接 /v1。
地址怎么填
| 场景 | 配置值 |
|---|---|
| 打开豆子 API 控制台 | https://api.beanc.cn |
| OpenAI Python / Node.js SDK 的 Base URL | https://api.beanc.cn/v1 |
| 直接发送文本对话 HTTP 请求 | https://api.beanc.cn/v1/chat/completions |
| 查询模型列表 | https://api.beanc.cn/v1/models |
Claude Code 的 ANTHROPIC_BASE_URL | https://api.beanc.cn |
客户端若会自行追加 /v1，服务地址应按该客户端的约定填写。具体见 Cherry Studio 和 Claude Code。
避开两种错误
text
正确：/v1/chat/completions
重复：/v1/v1/chat/completions
遗漏：/chat/completionsBase URL 字段通常不接受完整的 /chat/completions 地址，否则 SDK 可能再次追加路径。
模型 ID 从哪里来
在价格与模型页面选择与你的密钥分组一致的模型，复制模型 ID。也可以通过 API 查询该密钥可见的模型。
YOUR_MODEL_ID 是文档占位符，不是可调用的模型。不要用厂商名称、中文展示名或自行缩写替代真实 ID。
同一个模型能走哪些协议
Chat Completions、Responses 和 Anthropic Messages 是不同的请求格式。模型在列表中出现，只能说明它对当前配置可见，不能单独证明支持所有格式、工具调用或流式事件。
先用本文档的最小示例验证所需协议，再逐项增加高级参数。遇到模型不可用时，检查模型 ID、分组、密钥限制与该模型支持的接口。