BigModel API 新手教程：从注册到第一次调用
这篇教程面向第一次接入 BigModel API 的开发者，按照注册登录、充值并确认额度、创建 API 令牌、读取模型列表、发送首个请求和核对结果的顺序完成一次最小调用。BigModel 当前提供兼容 OpenAI 风格的 API 网关；模型和线路可能变化，因此示例不写死模型名称，而是要求使用当前账号从模型列表实际取得的模型 ID。
功能简介
BigModel 控制台提供账户、充值与钱包、API 令牌、模型和使用日志等入口。开发者通过 https://api.bigmodel.org/ 进入控制台，创建令牌后使用 Bearer Token 调用 API。首次接入建议先请求模型列表，再发送非流式聊天请求，这样能分别验证账号额度、认证、网关地址、模型 ID 和请求体。
开始前需要准备什么
- 一个可以登录 BigModel 控制台的账号。
- 当前账户可用的额度；充值金额、支付方式和模型价格以控制台实时页面为准。
- 可以运行 curl 的终端，或一个只在服务端保存密钥的开发环境。
API 令牌属于敏感凭据，不要放入前端 JavaScript、浏览器页面、客户端安装包或公开代码仓库。本文示例中的 YOUR_API_KEY 和 MODEL_ID_FROM_MODELS 都是占位符。
使用步骤
1. 注册并登录控制台
打开 BigModel 控制台入口 https://api.bigmodel.org/，通过页面提供的注册入口创建账号，然后登录。登录后再进行充值、令牌创建和模型确认；未登录状态下不要从第三方页面获取或提交 API Key。
2. 充值并确认可用额度
进入控制台的充值或钱包相关页面，按当前页面展示的方式完成充值。本文不写固定金额、折扣、到账时间或支付渠道，因为这些信息可能调整，应以操作时的控制台为准。完成后回到余额或额度页面，确认账户显示有可用额度，再继续调用测试。
3. 创建并保存 API 令牌
进入控制台的 API 令牌管理入口，创建一个用于本次测试的令牌，并安全保存页面返回的 Key。建议在服务端通过环境变量管理，例如 BIGMODEL_API_KEY，请求时放入 Authorization 头。不要在文章、截图、日志或错误反馈中暴露完整令牌。
Authorization: Bearer YOUR_API_KEY4. 获取模型列表并选择模型
不要照抄旧教程中的模型名。先调用当前网关的模型列表接口，用它验证地址与令牌，并从响应中选择当前账号实际可见的模型 ID。
curl https://api.bigmodel.org/v1/models -H "Authorization: Bearer YOUR_API_KEY"请求成功后，从返回的模型数据中复制一个实际模型 ID，并在下一步替换 MODEL_ID_FROM_MODELS。模型是否可调用、支持哪些参数，应以当前模型列表和 API 文档为准。
5. 发送第一个聊天请求
以下是用于验证链路的最小非流式请求。它只使用站内现有教程已经确认的聊天路径、Bearer 认证、model、messages 和 stream 字段。
curl https://api.bigmodel.org/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"MODEL_ID_FROM_MODELS","messages":[{"role":"user","content":"请用一句话介绍你自己。"}],"stream":false}'6. 验证返回结果和使用日志
终端收到成功的 JSON 响应后，检查非流式聊天结果中是否包含生成内容。站内现有 Python 示例通过 response.choices[0].message.content 读取内容。随后打开控制台的使用日志，核对刚才的调用记录和 Token 消耗；数据库或控制台中的实际记录比仅观察客户端界面更适合确认请求是否经过 BigModel。
参数说明
| 项目 | 用途 | 首次调用建议 |
|---|---|---|
https://api.bigmodel.org/v1 | OpenAI 兼容客户端使用的基础地址 | 具体接口路径追加在 /v1 后。 |
Authorization | 请求认证头 | 值使用 Bearer YOUR_API_KEY。 |
model | 指定本次请求的模型 | 填写 /v1/models 当前返回的真实模型 ID。 |
messages | 聊天消息数组 | 最小测试包含一条 role=user 和对应 content。 |
stream | 控制是否分段返回 | 首次验证使用 false，便于直接检查完整响应。 |
OpenAI SDK 示例
已有 OpenAI SDK 的项目可以把 base_url 设置为 https://api.bigmodel.org/v1，从服务端环境变量传入 BigModel API Key，并使用模型列表返回的真实模型 ID。站内现有示例使用 client.chat.completions.create 发起请求，再读取 response.choices[0].message.content。
常见问题
创建令牌后为什么仍然无法调用？
先确认账户有可用额度，再检查 Key 是否完整、请求头是否包含 Bearer、地址是否使用正确的 /v1 路径，以及模型 ID 是否来自当前模型列表。
模型名称应该从哪里获得？
调用 GET https://api.bigmodel.org/v1/models，使用当前响应中的模型 ID。不要把旧文章中的示例模型名当作长期可用清单。
返回 401 时如何排查？
检查 Authorization 请求头、Bearer 前缀和 API Key。还应确认 Key 没有复制错误，并避免在 Key 前后留下空格。
如何判断第一次调用已经成功？
先确认接口返回成功的 JSON 和生成内容，再到控制台使用日志核对对应调用记录与 Token 消耗。两处都能对应上，说明认证、模型选择和请求链路已经跑通。
充值金额和模型价格是多少？
本文不提供固定数值。充值方式、可选金额和模型价格应以 BigModel 控制台及当前定价页面实时显示为准。
小结
BigModel API 的新手接入链路可以压缩为六步：注册登录、充值并确认额度、创建并保管 API 令牌、请求 /v1/models 选择真实模型 ID、调用 /v1/chat/completions，最后用响应内容和使用日志共同验证结果。首次请求跑通后，再依据所选模型和当前文档逐步增加其他参数。
