白云 API 教程：Python、Node.js 与 LangChain
服务端环境变量、Responses / Chat SDK 最小示例与重试。 附完整检查步骤、实操验证和错误处理。
Python、Node.js 与 LangChain
服务端保存密钥
密钥通过进程环境变量 BAIYUN_API_KEY 读取。浏览器网页和移动应用不能内置共享密钥；需要由你自己的后端鉴权、限额后代发请求。部署前检查日志是否会打印请求头或环境变量。
Python
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["BAIYUN_API_KEY"],
base_url="https://api.baiyun.si/v1",
timeout=120.0, max_retries=0)
response = client.responses.create(model="gpt-6-luna",
input="用一句话说明 Token 是什么。")
print(response.output_text)output_text 是 SDK 提供的便利属性；直接解析 REST JSON 时应遍历 output 消息项中的文本字段。安装依赖应使用隔离环境，保留项目锁文件；不要为了测试升级整个生产项目。
Node.js
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.BAIYUN_API_KEY,
baseURL: 'https://api.baiyun.si/v1',
maxRetries: 0,
timeout: 120000,
});
const stream = await client.chat.completions.create({
model: 'gpt-6-luna', stream: true,
messages: [{role: 'user', content: '你好'}],
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}LangChain
使用支持 OpenAI 兼容地址的模型适配器，在其当前版本中设置 API Key、Base URL 与模型。先调用普通文本，再添加链、检索或工具；框架自动附加的额外参数仍须符合本站开放范围，不要把框架名称当成兼容保证。
错误与重试
首先区分 HTTP 状态、SDK 解析错误和业务返回错误。生成中断可能已经产生消费，不要自动无限重试；429 按提示退避，401 修复凭据，400 修复参数。连接超时应核对状态页和网络，再决定是否重试。
Python SDK 官方项目 · Node SDK 官方项目 · LangChain 官方文档
实操前的检查清单
- 准备自己的账户与调用密钥，不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型，便于排查时复现。
- 保存原配置或截图，隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK，先用一句话、一次请求开始。
- 查阅当前模型广场与状态页，再决定是否启用更多功能。
详细排查：把请求问题与代码问题分开
先用相同密钥和模型运行最小 curl，再比较 SDK 的实际地址、请求协议和参数。curl 成功而 SDK 失败时，排查代理环境、SDK 自动重试、超时和额外字段。不要在错误日志中打印 Authorization；部署中的密钥也不能写到前端构建变量。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议，能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准；账户教程以安全信息完善为标准；计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误，记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥，也不要把密码和验证码交给其他人。对 401 应先解决认证，对 400 应先解决参数，对 429 应停止密集重试，对 404 应核对请求路径与上游是否实现，不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤，用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能，先查看对应协议教程，再考虑添加功能；一次只变更一个配置，容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化；配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准；压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。