通义千问 API 怎么调用：从密钥到第一行代码

本文面向第一次接触 API 的新手，手把手完成从获取密钥到发出第一个请求的全过程。不依赖 SDK，只要 curl 和一个 OpenAI 风格的端点。

第一步：拿到密钥

在 Mycel 平台，通义千问 API 密钥通过 trade.pianam.cn 注册应用获得：

1. 访问 trade.pianam.cn 并登录
2. 进入开发者中心，创建应用
3. 在应用详情页即可看到 API Key

⚠️ 密钥是访问凭证，请妥善保管，不要泄露给他人。平台处于内测期，应用配额可能调整。

第二步：理解请求结构

OpenAI 兼容的 API 长得都一样：

• POST 到 /chat/completions 端点
• 密钥放在请求头（X-API-Key 或 Authorization: Bearer，大多数网关两种都认）
• JSON 请求体带 model 名称和 messages 数组

第三步：发出第一个请求

curl -X POST \
  'https://api.pianam.cn/api/v1/open/chat/completions' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "qwen-plus",
    "messages": [
      {"role": "user", "content": "用一句话打个招呼"}
    ]
  }'

成功的话，你会拿到 JSON，模型的回复在 choices[0].message.content 里。

第四步：读懂响应

三个字段最值得认识：

• choices[0].message.content —— 模型回答
• usage —— token 计数；按次计费的平台可以不关心，按 token 计费的平台这是成本驱动
• error —— 出错时先读这里

第五步：Python 最小示例

import requests

resp = requests.post(
    "https://api.pianam.cn/api/v1/open/chat/completions",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "model": "qwen-plus",
        "messages": [{"role": "user", "content": "写一首关于 API 的俳句"}],
    },
    timeout=60,
)
print(resp.json()["choices"][0]["message"]["content"])

新手常见报错对照表

收个尾

整个旅程就是：密钥 → 请求头 → POST → 解析。之后可以加流式输出（SSE）、函数调用、系统提示词——但核心请求的结构不会变。