阿里云百炼免费额度怎么领：新用户每模型各送百万 tokens

百炼提供 OpenAI 兼容接口。如果你已经在使用 OpenAI SDK，只需替换 base_url 和模型名，请求路径与请求体格式保持不变。兼容模式的 base_url 是 https://dashscope.aliyuncs.com/compatible-mode/v1，对话补全接口在其后拼接 /chat/completions。

模型名可以在控制台的模型广场或模型列表里查到，常用的有 qwen-plus、qwen-turbo、qwen-max、qwen-long，以及平台上架的 deepseek-v3、glm-4.5 等第三方模型。准确可用的型号以控制台显示为准；模型下线或更名后，旧名称会直接返回错误。

先把密钥放进环境变量

这样密钥不会出现在命令历史和代码仓库里：

export DASHSCOPE_API_KEY="控制台创建的密钥"

用 curl 验证一次对话补全

确认链路通不通，先用一条最简单的请求试通，再接入业务代码：

curl https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-plus",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手"},
      {"role": "user", "content": "用一句话解释什么是 REST API"}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

用 OpenAI SDK 调用（Python）

安装 openai 包后即可运行下面这段代码，只改 base_url 和模型名，其余写法和官方示例一致：

import os
from openai import OpenAI

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

resp = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "你是一个简洁的助手"},
        {"role": "user", "content": "用一句话解释什么是 REST API"},
    ],
    temperature=0.7,
    max_tokens=512,
)

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

关键参数说明

• model：必填，填控制台里可用的模型名；额度按模型分别计算，换模型等于换一份额度。
• messages：必填，角色数组，支持 system、user、assistant；多轮对话需要自己把历史消息带上。
• temperature：采样随机度，取值 0 到 2，做抽取、分类这类确定任务时建议调低。
• max_tokens：限制输出长度；输入和输出都会计入同一份额度，长上下文加长输出消耗更快。
• stream：设为 true 时按 SSE 增量返回，适合聊天界面，注意客户端要逐块拼接。
• top_p：与 temperature 一般只调其中一个，避免采样行为难以复现。

额度耗尽与限流的典型表现

• 返回 401 类错误、提示密钥无效：密钥拼错、被删除或复制不全。
• 返回 429 类错误或提示触发限流：超过每秒请求数或并发上限，需要降低频率并做指数退避重试。
• 提示欠费或账号余额不足：该模型的免费额度已用完或已过 90 天有效期，账号已进入按量计费且余额不够。
• 提示模型不存在或不支持：模型名拼错，或该模型不在免费额度范围内、未在北京地域开通。

排查顺序建议是：先核对密钥与 base_url 是否正确、地域是否为华北 2（北京）；再确认模型名与是否在免费范围内；然后到控制台看用量与免费额度的剩余量和到期时间；最后再看是否触发限流以及账单是否有欠费。返回的错误码以接口实际返回为准，不要凭记忆猜测。