千问 API 接入文档
应用工作台 服务门户 管理后台

快速开始

本服务完全兼容 OpenAI Chat Completions 协议。拿到 API Key 后，把 base_url 指向本服务即可，其余代码无需改动。

Base URL兼容 OpenAI SDK / curl
—

一、获取 API Key

在服务门户提交申请，管理员审核后发放。Key 形如 qwen_ 开头的字符串，属于你个人使用，请勿公开。

传 Key 的方式取决于你的部署环境：

云端网关环境下的写法

import httpx
from openai import OpenAI

client = OpenAI(
    api_key="qwen_你的KEY",
    base_url="—",
    http_client=httpx.Client(headers={"Api-Key": "qwen_你的KEY"}),
)

二、调用示例

Python（OpenAI SDK）

pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="qwen_你的KEY",
    base_url="—",
)

resp = client.chat.completions.create(
    model="qwen3.8-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "qwen_你的KEY",
  baseURL: "—",
});

const r = await client.chat.completions.create({
  model: "qwen3.8-flash",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

curl

curl —/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer qwen_你的KEY" \
  -d '{"model":"qwen3.8-flash","messages":[{"role":"user","content":"你好"}]}'

流式输出

stream = client.chat.completions.create(
    model="qwen3.8-flash",
    messages=[{"role": "user", "content": "写一首诗"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

三、接口清单

方法路径说明
POST/v1/chat/completions对话补全，支持 stream
GET/v1/models你可用的模型列表
GET/v1/usage你的用量统计
GET/v1/my-invoice你的账单明细
GET/api/pricing公开定价表
POST/api/apply提交 Key 申请

四、模型与价格

模型说明输入 ¥/百万输出 ¥/百万上下文
加载中…

五、错误码

HTTPcode含义与处理
401invalid_api_keyKey 缺失或错误，检查是否复制完整
403model_not_allowed该模型未开通，看响应里的可用模型列表
403account_disabled账号被停用，联系管理员
403ip_not_allowed来源 IP 不在允许范围
429rate_limit超出 RPM/TPM，等一分钟重试
429quota_exceeded超出每日/月度额度，联系管理员提额
502upstream_error上游模型服务异常，稍后重试
关于内容合规：生成式 AI 输出可能存在偏差，请勿直接用于医疗、法律、金融等高风险决策场景。面向境内公众提供服务时，需按规定完成算法备案或服务登记。

六、隐私与数据