常见问题

Base URL 到底要不要加 /v1？

OpenAI Python / Node.js SDK 填 https://api.beanc.cn/v1；Claude Code 的 ANTHROPIC_BASE_URL 填 https://api.beanc.cn。会自行补版本路径的客户端按其规则填写，见地址对照。

API Key 填账号密码吗？

不是。在密钥管理创建访问密钥。客户端的 Key 字段通常只填密钥本身，不加 Bearer；手写 HTTP 请求头时再使用 Authorization: Bearer ...。

该填哪个模型名称？

使用控制台的完整模型 ID，或查询模型列表。本文中的 YOUR_MODEL_ID 只是占位符。可用模型与权限以账号和密钥分组为准。

有图片生成或视频生成吗？

没有。豆子 API 当前文档不提供这两类服务的接口或接入教程。

为什么普通聊天成功，编程客户端却失败？

它们可能使用不同协议，或者额外依赖流式、工具调用和 Token 计数等能力。按 Claude Code 或 Codex 的前提逐项核对，不要只测试普通聊天。

客户端的联网搜索、知识库能直接用吗？

这些功能可能需要客户端自己的搜索服务、嵌入模型或额外工具配置。能聊天不代表其他能力自动可用；先确认客户端及所需模型的实际支持情况。

对话历史会自动接着上次继续吗？

Chat Completions 的基础调用需要应用自行发送所需历史。只发送最新一句时，模型不会自动读取你上一次调用的完整对话。历史越长，输入量通常也越大。

请求失败了会扣费吗？

先在使用日志中核对具体记录。超时、中断或客户端取消不能直接证明上游未执行；是否计费以站点规则与实际记录为准，见余额与计费。

文档站会保存我的密钥吗？

这个文档站没有密钥输入或在线调试功能。示例仅用于复制到你的本机或后端运行，页面不会替你发起模型调用。

示例运行不了，先看哪里？

确认已替换所有占位符，并在运行程序的同一终端设置环境变量。接着按错误排查核对地址、协议、模型、密钥和实际错误正文。