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

作为 Mycel 开发者平台支持的模型之一，通义千问 API 让您能快速集成大模型能力到自己的应用中。本文面向第一次接触 API 的新手，手把手带您完成从获取密钥到发出第一个请求的全过程。

拿到密钥

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

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

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

用 curl 发第一次请求

Mycel 的开发者 API 兼容 OpenAI 风格，使用标准 HTTP 请求，通过 X-API-Key 请求头鉴权（同时兼容标准的 Authorization: Bearer 写法）。以下是一个最简 curl 示例：

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": "你好，介绍一下你自己"}
    ]
  }'

Python requests 调用示例

import requests

API_KEY = "YOUR_API_KEY"
API_URL = "https://api.pianam.cn/api/v1/open/chat/completions"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

payload = {
    "model": "qwen-plus",
    "messages": [
        {"role": "user", "content": "你好，介绍一下你自己"}
    ]
}

response = requests.post(API_URL, headers=headers, json=payload)
print(response.status_code)
print(response.json())

积分计费说明

Mycel 使用统一积分体系，1元 = 100积分。开发者 API 按模型计分（积分在调用前预扣，上游失败自动返还）：

• qwen-flash：1积分/次（极速，日常问答与简单任务）
• qwen-plus：5积分/次（主力，写作/代码/长文，128K 上下文）
• qwq-plus：8积分/次（深度推理，数学/逻辑难题）
• qwen-vl-plus：5积分/次（图片理解）
• qwen-vl-max：8积分/次（图片+视频理解旗舰）
• BYOK（自带上游密钥）：仅收 0.5积分/次固定服务费

老代码常用的 qwen-turbo、deepseek-chat 等旧模型名会自动映射到对应新档位计费，无需改动即可迁移。发请求前可调用 GET https://api.pianam.cn/api/v1/open/models 查询最新模型列表与积分。

余额不足时请求会返回 402 错误，需前往充值页面补充积分。

常见报错排查

• 401 Unauthorized（提示"请先登录或提供 API Key"）：检查 X-API-Key 请求头是否正确携带、密钥是否过期，或应用是否被禁用
• 429 Too Many Requests：当前应用已达到速率限制，稍后重试或联系平台申请提升配额
• 超时（Connection timeout / Read timeout）：检查网络连接，或尝试增加超时时间（建议设置 connect_timeout=10s, read_timeout=30s）

温馨提示：Mycel 是一个 AI 对话工作台与开发者开放平台，内置多档主流大模型、技能广场、桌面助手。本文所述功能均基于当前平台能力，具体以 trade.pianam.cn 控制台实时信息为准。