OpenAI 兼容接口

​

快速迁移

import os
from openai import OpenAI

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

completion = client.chat.completions.create(
  model="qwen3.7-plus",
  messages=[{"role": "user", "content": "Hello!"}],
)
print(completion.choices[0].message.content)

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env.DASHSCOPE_API_KEY,
  baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1",
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: "qwen3.7-plus",
    messages: [{ role: "user", content: "Hello!" }],
  });
  console.log(completion.choices[0].message.content);
}

main();

curl https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

​

支持的 API

​

Chat Completions

​

Qwen 扩展参数

​

行为差异

• response_format 支持 json_object 和 json_schema。
• tool_choice 支持 auto、none、required 和指定函数对象（{"type": "function", "function": {"name": "..."}}）。
• tools 仅支持 function 类型。
• parallel_tool_calls 默认为 true（与 OpenAI 一致）。
• n 支持 1-4，仅限部分模型（qwen-plus、qwen-plus-character）。
• web_search_options 不支持，请改用 extra_body.enable_search 和 extra_body.search_options。

​

不支持的参数

​

Responses API

• 内置工具：web_search、code_interpreter、web_extractor 和 image_search，无需额外配置。
• 简化多轮对话：传入 previous_response_id 即可，无需手动构建完整消息历史。
• 对话集成：配合 Conversations API 实现自动上下文管理。
• 会话缓存：自动缓存跨轮次上下文，降低延迟和成本。通过 x-dashscope-session-cache: enable 请求头启用。参见会话缓存。

​

从 Chat Completions 迁移

1. 将 base_url 修改为 https://dashscope.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1，接口路径从 /v1/chat/completions 改为 /v1/responses。
2. 用 output_text 替代 choices[0].message.content 读取响应。
3. 多轮对话时传入 previous_response_id，无需手动追加消息。

​

Embedding

• encoding_format：支持 float（默认）和 base64。
• user：不支持（静默忽略）。
• dimensions：可选值取决于模型。例如 text-embedding-v4 支持 2,048、1,536、1,024（默认）、768、512、256、128 和 64。

​

File API

• purpose 仅支持 file-extract（用于 Qwen-Long/Qwen-Doc 文档分析）和 batch（用于批量处理）。不支持 OpenAI 的 fine-tune、assistants 等值。
• 文件内容获取（GET /v1/files/{file_id}/content）不支持。
• 列表过滤：GET /v1/files 的 purpose 和 order 参数不支持。
• 存储限制：最多 10,000 个文件，总容量 100 GB，文件永不过期。

​

Batch API

• 成本降低 50%：相比实时调用价格。
• completion_window：支持 24h 到 336h（14 天），接受 "h"（小时）和 "d"（天）为单位的整数值。OpenAI 固定为 24h。
• 扩展元数据：metadata.ds_name（任务名称）和 metadata.ds_description（任务描述）。
• 扩展列表过滤：支持 ds_name、input_file_ids、status、create_after、create_before。
• 输入文件限制：每个文件最多 50,000 条请求，单个文件大小不超过 500 MB，单行不超过 6 MB。同一文件中的所有请求必须使用相同模型。

​

Conversations API