服务端程序接入

如果你在后端程序中接入云桥AI，建议优先使用标准 OpenAI 风格 SDK 或直接发 HTTP 请求。

最小接入条件

Base URL：https://yunqiaoai.com.cn/v1
Header：Authorization: Bearer <API Key>
Content-Type：application/json

什么时候优先用 SDK

优先用 SDK 的场景：

你已经在用 OpenAI 官方风格 SDK
只需要快速替换供应商地址
想减少手写 HTTP 细节

什么时候直接发 HTTP 请求

优先用原始 HTTP 的场景：

你在排查底层请求问题
你要验证第三方 SDK 是否自动改写参数
你需要最明确地看到请求和响应内容

服务端最佳实践

用环境变量保存 API Key
把失败响应体写入日志，但不要打印完整密钥
把 Base URL 和模型名做成可配置项
给 429、5xx、timeout 做合理重试

常见问题

网页能用，服务端不能用

通常是服务端配置问题，而不是平台问题。重点检查：

代码里填的 Base URL
是否真的带上了 Authorization 头
运行环境里有没有正确加载 API Key

本地能用，服务器不能用

优先检查：

服务器网络是否能访问目标域名
运行环境是否缺少变量
出站代理、防火墙或容器网络是否有差异