百炼北京地域新人免费模型 API
api
- EndpointEndpoint
https://dashscope.aliyuncs.com/compatible-mode/v1- 认证Authentication
- Authorization: Bearer API key
额度与限制Limits
通常每模型 100 万 Tokens，90 天有效；OAuth 认证另有每日 2000 次独立免费额度；具体模型额度与 RPM/TPM 以模型页为准。
前置条件Prerequisites
- 阿里云百炼北京地域账户See official terms
- 通用 DASHSCOPE API KeyDASHSCOPE API Key
- 目标模型仍有新人免费额度See official terms
操作步骤Steps
- 确认免费额度
在百炼免费额度页确认目标模型的剩余额度、90 天到期时间，并确认该模型支持免费额度。
- 开启用完即停
已实名用户建议开启“免费额度用完即停”；未实名用户系统默认强制停止。
- 使用通用 API Key
不要使用 Token Plan / Coding Plan 专属 Key；通用 Key 的实时推理会优先扣免费额度。
- 发送最小请求
使用北京地域 OpenAI 兼容 Base URL 调用目标模型。
可复制命令Copyable commandexport DASHSCOPE_API_KEY="你的 Key" curl 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；免费额度页面出现对应消耗，且没有现金账单。
- Python SDK 示例
安装 OpenAI SDK；在运行环境设置 DASHSCOPE_API_KEY，示例代码通过环境变量读取密钥。
可复制命令Copyable commandpython -m pip install -U openai import os from openai import OpenAI client = OpenAI( api_key=os.environ["DASHSCOPE_API_KEY"], base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", ) response = client.chat.completions.create( model="qwen-plus", messages=[{"role": "user", "content": "用一句话解释 API 是什么。"}], ) print(response.choices[0].message.content)预期结果Expected：终端打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。
- Node.js SDK 示例
安装 OpenAI SDK；在运行环境设置 DASHSCOPE_API_KEY，示例代码通过环境变量读取密钥。
可复制命令Copyable commandnpm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.DASHSCOPE_API_KEY, baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1", }); const response = await client.chat.completions.create({ model: "qwen-plus", messages: [{ role: "user", content: "用一句话解释 API 是什么。" }], }); console.log(response.choices[0].message.content);预期结果Expected：Node.js 打印模型生成的回复；再到提供商控制台确认请求状态和额度扣减。
验证动作Validation
请求成功，并在免费额度页确认扣减来自目标模型的新人免费额度；已实名账号确认用完即停已开启。
常见问题Common issues
- 只有北京地域支持新人模型免费额度。。
- Token Plan/Coding Plan 专属 Key 不会消耗新人免费额度。Token Plan/Coding Plan Key 。
- 已实名用户未开启用完即停时，额度耗尽后可能自动转 PAYG。， PAYG。