统一地址、协议选择、最小请求与兼容范围。 附完整检查步骤、实操验证和错误处理。

OpenAI Compatible 接入

三项核心配置

Chat Completions 与 Responses 是两种请求协议，不是两种密钥。普通聊天客户端一般使用 Chat；Codex 自定义供应商使用 Responses。模型列表与价格以模型广场的实际公示为准。

先验证模型列表

curl --fail-with-body https://api.baiyun.si/v1/models   -H "Authorization: Bearer $BAIYUN_API_KEY"

BAIYUN_API_KEY 是你在本机私下设置的环境变量，不要把真实值写进教程、代码仓库或截图。401 先检查密钥，404 先检查地址，429 先等待，不要无限重试。

再发最小文本请求

curl --no-buffer --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":true}'

流式请求逐段返回。能列出模型不代表已经成功生成；能生成普通文本也不代表图片、音频、文件、搜索或全部工具都可用。先保持最小设置，再按本站实际开放范围逐项启用功能。

参数与能力边界

不要把客户端自动补上的 tools、图片、附件或历史引用都当成通用能力。当前 Codex 通路有专门适配，普通客户端仍应先用纯文本。上下文压缩路径已开放，但上游此前返回过 404；遇到该错误时不能靠反复换密钥修复。

实操前的检查清单

1. 准备自己的账户与调用密钥，不使用他人的共享凭据。
2. 记录客户端版本、系统和准备使用的模型，便于排查时复现。
3. 保存原配置或截图，隐藏密钥、验证码与私人内容。
4. 确认测试可能消费少量 DK，先用一句话、一次请求开始。
5. 查阅当前模型广场与状态页，再决定是否启用更多功能。

详细排查：按顺序缩小问题范围

先确认账户已完善、密钥有效、DK 余额足够，再核对协议、地址与模型。用同一密钥做一次最小文本请求；它成功以后，才逐项恢复附件、工具或自动重试。客户端配置保存后重新打开会话，避免旧会话仍使用先前供应商。

怎样确认本节已经学会

不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议，能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准；账户教程以安全信息完善为标准；计费教程以本金、通道费与 DK 的对应关系核对为标准。

如果出现错误，记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥，也不要把密码和验证码交给其他人。对 401 应先解决认证，对 400 应先解决参数，对 429 应停止密集重试，对 404 应核对请求路径与上游是否实现，不能用重新充值解决所有报错。

一个适合练习的小任务

在自己的测试环境完成本节的最小步骤，用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能，先查看对应协议教程，再考虑添加功能；一次只变更一个配置，容易判断哪一步导致错误。

下一步与版本边界

返回完整学习地图 · API 站精简配置 · 本站实时状态。

教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化；配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准；压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。