阿里云百炼 API(OpenAI 兼容)

阿里云百炼(Model Studio)提供通义千问等模型的 OpenAI 兼容接口(/v1)。兼容模式核心端点包括聊天补全(/v1/chat/completions)与文本向量(/v1/embeddings),支持流式、工具调用、系统指令与上下文管理。需按地域配置 BASE_URL:北京(https://dashscope.aliyuncs.com/compatible-mode/v1)与新加坡(https://dashscope-intl.aliyuncs.com/compatible-mode/v1)。

基础 URL
https://dashscope.aliyuncs.com/compatible-mode/v1
认证
Bearer / Authorization: Bearer
官方 SDK
Python, Java
🔑 API Key 获取
前置要求:需阿里云主账号开通百炼与实名认证;根据配额与模型授权可能需充值或在业务空间开启模型权限。
入口:https://help.aliyun.com/zh/model-studio/get-api-key
说明:登录百炼控制台,在“密钥管理”创建 API Key(北京与新加坡地域的密钥互不通用),并建议配置到环境变量 `DASHSCOPE_API_KEY`。

支持模型

API 接口列表

POST /v1/chat/completions Docs

聊天补全(OpenAI 兼容)。支持非流式与流式输出、工具调用、系统指令与上下文会话。调用需使用对应地域 BASE_URL(北京或新加坡)与该地域的 API Key。

认证
频率限制600/min
计费模式按量计费(每千Token计费,输入/输出分别计费;不同模型价格不同,见计费页)。
{
  "model": "qwen-plus",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "请用中文自我介绍。"
    }
  ],
  "stream": true,
  "temperature": 0.7
}
POST /v1/embeddings Docs

文本向量(Embedding,OpenAI 兼容)。支持多语种文本向量化与维度选择(如 text-embedding-v4 支持 2048/1536/1024/768/512/256/128/64 等)。

认证
频率限制600/min
计费模式按量计费(例如 text-embedding-v4:每千输入Token约 CNY 0.0005;Batch约 CNY 0.00025),详见官方页面。
{
  "model": "text-embedding-v4",
  "input": "衣服的质量杠杠的,很漂亮,不枉我等了这么久啊,喜欢,以后还来这里买",
  "encoding_format": "float",
  "dimensions": 1024
}