把现有OpenAI SDK程序改为调用千问，需要一起修改API密钥、base_url和模型名称。只换模型名，客户端仍可能请求原服务；只换密钥，也不会自动找到百炼入口。兼容接口允许复用调用形式，不表示所有功能完全相同。
SDK填基础地址，HTTP填完整路径
使用OpenAI SDK的聊天补全方法时，base_url应填对应地域的兼容基础地址，路径到compatible-mode/v1。直接发送HTTP请求时，才使用带chat/completions的完整接口路径。两种示例不能互相照抄。
地址中出现业务空间占位符时，须替换为实际空间标识，地域也要与密钥匹配。可结合千问API教程核对配置，避免把界面聊天网址填进客户端。
从一条短文本请求开始迁移
在客户端认证参数中读取环境变量里的百炼密钥，模型名使用目标地域支持的名称。先发送只有messages的短文本，确认返回message.content后，再恢复流式、工具和其他参数。
这种逐项恢复的方法便于定位不兼容项。密钥应保留在服务端，调试日志不要输出完整认证头；部署后还要确认运行进程确实读取到了新环境变量。
按功能验证兼容范围
不同模型和模态的支持范围需要分别检查，不能因文本请求成功就推断音频、视觉和工具参数全部可用。例如Qwen-Audio不支持这一兼容协议，需要使用对应的DashScope协议。从其他AI接口迁入的程序，应将附件、工具与结果解析逐项验收后再切换生产流量，保留原配置便于排查差异。
原创文章，作者：eastbtc，如若转载，请注明出处：https://www.eastbtc.com/ai/qwen/30120.html
