Qwen

Qwen 文本能力包含聊天补全和机器翻译等用途，接口都使用 OpenAI Chat Completions 兼容路径。本页按能力区分模型选择与参数差异。

接口路径

方法	路径	用途
POST	`/v1/chat/completions`	Qwen 聊天补全或机器翻译请求

curl -X POST "https://api.routescope.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用一句话介绍自己。"
      }
    ]
  }'

curl -X POST "https://api.routescope.ai/v1/chat/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-4o-mini",    "messages": [      {        "role": "user",        "content": "你好，请用一句话介绍自己。"      }    ]  }'

{
  "id": "task_01JZ8M9Q4R7V2K8N9P0Q",
  "object": "string",
  "created": 1,
  "model": "gpt-4o-mini",
  "choices": [],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "input_tokens": 1,
    "output_tokens": 1
  }
}

{
  "error": null,
  "message": "success"
}

Authorization

BearerAuth

AuthorizationBearer <token>

模型 relay 接口鉴权。请求头：Authorization: Bearer 。

In: header

Request Body

application/json

model*string

要调用的模型名称。

messages*

对话消息列表。对话消息列表。范围：至少 1 条消息。

temperature?number

采样温度，值越大越发散。采样温度。范围：0 到 2；值越大输出越随机。

Range0 <= value <= 2

top_p?number

核采样参数。核采样参数。范围：0 到 1；通常不要和 temperature 同时大幅调整。

Range0 <= value <= 1

max_tokens?integer

最大输出 Token 数。最大输出 Token 数。范围：1 到模型上下文上限。

Range1 <= value

stream?boolean

是否启用 SSE 流式输出。是否启用流式输出。范围：true 或 false。

stream_options?

流式扩展选项。不同上游支持情况不同。

enable_thinking?boolean

是否开启深度思考模式。千问（Qwen）/阿里云百炼 OpenAI 兼容接口扩展参数：true 开启思考，false 关闭思考；部分仅思考模型始终开启且不支持关闭。Python OpenAI SDK 可通过 extra_body 传入。

tools?

可供模型调用的工具定义。工具定义列表。范围：数组长度和 schema 复杂度以上游限制为准。

tool_choice?string|

工具调用策略，例如 auto、none 或显式指定函数。工具调用策略。范围：auto、none、required 或显式工具对象。

response_format?object

结构化输出约束，例如 JSON Schema。

user?string

终端用户标识，用于审计和风控。

Response Body

application/json

模型选择表

模型 ID	能力类型	适用场景
`qwen2.5-14b-instruct`	聊天补全	通用指令和对话
`qwen3.5-397b-a17b`	聊天补全	更复杂的文本任务
`qwen3.5-flash`	聊天补全	轻量或低延迟对话
`qwen3.5-plus`	聊天补全	通用增强对话
`qwen3-max-preview`	聊天补全	预览模型
`qwen-mt-flash`	机器翻译	低延迟翻译
`qwen-mt-plus`	机器翻译	通用翻译
`qwen-mt-turbo`	机器翻译	高吞吐翻译

通用参数

字段	类型	必选	说明
`model`	string	是	Qwen 模型 ID。
`messages`	array	是	OpenAI 风格对话消息列表；翻译任务可把源文和要求放在消息中。
`temperature`	number	否	采样温度。
`top_p`	number	否	核采样参数。
`max_tokens`	integer	否	最大输出 Token 数。
`stream`	boolean	否	是否流式输出。
`tools`	array	否	工具定义列表。
`response_format`	object	否	结构化输出约束。
`user`	string	否	终端用户标识。

模型差异参数

字段	适用模型	差异说明
`model`	`全部 Qwen 模型`	请求体中传入具体模型 ID。
`enable_thinking`	`Qwen / 阿里云百炼 OpenAI 兼容扩展参数`	OpenAPI schema 标注：true 开启思考，false 关闭思考；部分仅思考模型始终开启且不支持关闭。Python OpenAI SDK 可通过 extra_body 传入。
`翻译提示词结构`	`qwen-mt-flash、qwen-mt-plus、qwen-mt-turbo`	用途为机器翻译，但接口仍为 Chat Completions；翻译要求通过消息表达。

接口路径

Authorization

Request Body

Response Body

200application/json

400application/json

模型选择表

通用参数

模型差异参数

application/json

application/json