白云 API 教程：快速开始
从登录、充值和创建密钥，到第一个纯文本 API 请求。 附完整检查步骤、实操验证和错误处理。
快速开始
本页帮助你从网站聊天或 API 调用开始使用本站。当前服务范围为完整、可检查的纯文本请求。
在网站体验
- 注册或登录本站账户。
- 打开钱包，确认 Doken（词刀，DK）数量和人民币实付金额后，通过支付宝或微信充值；当前单价 0.30 元/DK。
- 打开聊天体验，选择已开放模型，先提交一条简短、正常的文本问题。
- 在控制台查看用量与消费记录。
当前按余额消耗，不需要购买会员订阅。充值与调用前请阅读使用规则。
为应用创建调用密钥
在密钥管理创建用于模型调用的 API 密钥；根据实际需求设置余额与模型限制，保存后妥善保管。
应用使用的是模型调用密钥，不是网页登录密码。不要把密钥写入公开代码、截图、聊天内容或可被浏览器访问的前端代码。已经泄露的密钥应在密钥管理中撤销并重新创建。
配置客户端
| 配置项 | 当前填写内容 |
|---|---|
| API Base URL | https://api.baiyun.si/v1 |
| API Key | 在本站密钥管理创建的调用密钥 |
| 模型 | 例如 gpt-6-luna；准确列表见模型广场 |
| 接口 | Chat Completions 或 Responses 的文本模式 |
不同客户端对地址的定义不同：填写 Base URL 时通常保留 /v1；如果要求填完整 Chat 地址，则填 https://api.baiyun.si/v1/chat/completions。不要把 /v1 重复拼接两次。不能默认所有客户端、插件及功能都兼容。
第一个 API 请求
在本机终端设置环境变量，输入密钥时避免进入共享终端或录屏：
read -r -s -p '请输入本站 API 密钥：' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY
curl --fail-with-body https://api.baiyun.si/v1/chat/completions \
-H "Authorization: Bearer $BAIYUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-6-luna",
"messages": [{"role": "user", "content": "你好，请用一句话介绍你能帮我做什么。"}],
"stream": false
}'成功请求返回生成文本与用量信息，并按公示参考单价扣除 DK 余额。1 DK 指按选定商业 API 参考报价价值 1 美元的那批 Token，不是固定 Token 数量或可兑换美元的现金。上面的正常请求也会产生少量消费。
当前 0.30 元/DK 是本站充值售价，不是已经实测证明的精确订阅成本；同批 Token 的参考价值、订阅成本与人民币或日元换算见三步计费说明。
想持续接收输出，查看Chat 流式示例；应用使用 Responses 时，查看Responses 示例。
检查可调用的模型
模型列表接口也需要密钥鉴权：
curl --fail-with-body https://api.baiyun.si/v1/models \
-H "Authorization: Bearer $BAIYUN_API_KEY"以当前密钥实际返回的模型为准。若模型不存在或不可用，请核对模型名称、密钥限制和余额，不要反复重试不受支持的请求。
实操前的检查清单
- 准备自己的账户与调用密钥，不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型，便于排查时复现。
- 保存原配置或截图，隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK，先用一句话、一次请求开始。
- 查阅当前模型广场与状态页，再决定是否启用更多功能。
详细排查：按顺序缩小问题范围
先确认账户已完善、密钥有效、DK 余额足够，再核对协议、地址与模型。用同一密钥做一次最小文本请求；它成功以后，才逐项恢复附件、工具或自动重试。客户端配置保存后重新打开会话，避免旧会话仍使用先前供应商。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议，能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准；账户教程以安全信息完善为标准；计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误，记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥，也不要把密码和验证码交给其他人。对 401 应先解决认证，对 400 应先解决参数，对 429 应停止密集重试，对 404 应核对请求路径与上游是否实现，不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤，用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能，先查看对应协议教程，再考虑添加功能；一次只变更一个配置，容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化；配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准；压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。