通义千问 OpenAI 兼容 API
api
- EndpointEndpoint
https://dashscope.aliyuncs.com/compatible-mode/v1- 认证Authentication
- Authorization: Bearer API key
额度与限制Limits
当前记录通常为每个模型 1,000,000 input + output tokens，新用户、地域、模型和额度耗尽行为以官方页面实时状态为准。
前置条件Prerequisites
- 阿里云百炼账户See official terms
- 已选择官方支持的地域See official terms
- 已创建 Model Studio API keyModel Studio API key
- 已阅读免费额度和额度耗尽行为See official terms
操作步骤Steps
- 确认免费额度
打开官方免费额度说明，确认目标模型、地域和当前新用户资格。
操作Action：打开 https://help.aliyun.com/zh/model-studio/new-free-quota
- 创建 API key
在百炼控制台创建 API key，并只保存到本地环境变量 DASHSCOPE_API_KEY。
- 开启耗尽停止
在控制台开启免费额度耗尽后的停止设置，避免测试请求意外进入付费计费。
- 发送最小请求
使用官方兼容 endpoint 和当前可用的 Qwen 模型 ID 发送短文本请求。
可复制命令Copyable commandcurl https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions -H 'Authorization: Bearer ${DASHSCOPE_API_KEY}' -H 'Content-Type: application/json' --data '{"model":"qwen-plus","messages":[{"role":"user","content":"Hello"}]}'预期结果Expected：返回 HTTP 200 和 choices[0].message.content。
验证动作Validation
请求返回 HTTP 200 和 choices[0].message.content；同时在百炼控制台确认免费额度没有意外转入付费。
常见问题Common issues
- 免费额度通常与地域和新用户资格绑定。。
- 模型 ID 变化或不可见时以官方模型列表为准。ID 。
- 未开启额度耗尽停止设置前不要进行大批量测试。。