首次调用千问API

千问云提供新人免费额度。详见免费额度。

完成本指南后，您将能用Python、Node.js或其他语言发起真实请求。如果您已在使用OpenAI SDK，无需重新学习——只需将 base_url 指向千问云、替换API Key，即可复用现有代码。

若您熟悉大模型调用，可直接查看API参考文档。
若您不熟悉编程，可参考模型体验，通过图形化界面与千问模型对话。
API调用与操作系统版本无关，只要网络能连通即可正常使用。

本文以千问为例，引导您完成大模型API调用。按照以下步骤操作：

步骤一：创建账号并获取API Key
步骤二：配置API Key到环境变量
步骤三：调用千问API

步骤一：创建账号并获取API Key

登录千问云

访问千问云，使用手机号、账号密码或支付宝扫码登录。

获取 API Key

进入 API Key 页面，点击创建 API Key，复制生成的 Key（以 sk- 开头）。详细说明 →

请妥善保管 API Key，不要提交到代码仓库或公开分享。

步骤二：配置API Key到环境变量

建议将API Key配置到环境变量，而不是直接写在代码里，以降低泄露风险。

export DASHSCOPE_API_KEY="sk-your-api-key-here"

如需跨会话持久化配置，参见配置 API Key →。

步骤三：调用千问API

选择您熟悉的语言或工具。千问云兼容OpenAI SDK——如果您已安装，只需更新 base_url 和API Key即可直接使用。

Python
Node.js
curl

安装 OpenAI SDK：

pip install openai

创建文件 hello_qwen.py：

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
  model="qwen3.7-plus",
  messages=[
    {"role": "user", "content": "Hello! Tell me a fun fact about AI."}
  ]
)

print(completion.choices[0].message.content)

运行：

python hello_qwen.py

安装 OpenAI SDK：

npm install openai

创建文件 hello_qwen.mjs：

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env.DASHSCOPE_API_KEY,
  baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1"
});

const completion = await openai.chat.completions.create({
  model: "qwen3.7-plus",
  messages: [
    { role: "user", content: "Hello! Tell me a fun fact about AI." }
  ]
});

console.log(completion.choices[0].message.content);

运行：

node hello_qwen.mjs

curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [
      {
        "role": "user",
        "content": "Hello! Tell me a fun fact about AI."
      }
    ]
  }'

Java、Go、PHP、C# 等语言可直接使用 curl 标签页中的 OpenAI 兼容端点，配合各语言的 HTTP 客户端调用。Java 也可使用 DashScope Java SDK。

在模型市场中，推理服务商为千问云的模型无需手动开通，获取 API Key 后即可直接调用（部分邀测模型除外）。其他推理服务商（如硅基流动）的直供模型，需要先在模型市场开通后才能调用。

下一步

文本生成指南 — 流式输出、函数调用等进阶用法
视觉模型 — 图片和视频分析
模型选择 — 选择适合场景的模型
模型体验 — 在线试用模型

​步骤一：创建账号并获取API Key

​步骤二：配置API Key到环境变量

​步骤三：调用千问API

​下一步

步骤一：创建账号并获取API Key

步骤二：配置API Key到环境变量

步骤三：调用千问API

下一步