qwen-turbo (文本转文本)
接口地址
POST /v1/chat/completions身份认证
请求示例
参数说明
核心参数
| 参数 | 类型 | 必填 | 默认值 | 范围 | 描述 |
|---|---|---|---|---|---|
model | string | 是 | - | - | 用于生成响应的模型 ID，如 qwen-turbo。Alibaba 提供多种具有不同功能、性能特点和价格点的模型。请参考模型指南浏览和比较可用模型。 |
messages | array | 是 | - | - | 包含当前对话的消息列表。根据您使用的模型，支持不同的消息类型（模态），如文本、图片和音频。 |
>messages.role | string | 是 | - | developer、user、system | 消息作者的角色。 |
>messages.name | string | 否 | - | - | 参与者的可选名称。为模型提供信息以区分相同角色的参与者。 |
>messages.content | string / array | 是 | - | - | 开发者消息的内容。 |
>>messages.content.type | string | 是 | - | text、image_url | 内容部分的类型 |
>>messages.content.text | string | 否 | - | - | 文本内容 |
高级参数
| 参数 | 类型 | 必填 | 默认值 | 范围 | 描述 |
|---|---|---|---|---|---|
max_tokens | integer / null | 否 | - | - | 聊天补全中可生成的最大 token 数量。输入 token 和生成 token 的总长度受模型上下文长度限制。 |
n | integer / null | 否 | 1 | 1 - 10 | 为每条输入消息生成多少个聊天补全选项。请注意，您将根据所有选项中生成的 token 数量付费。 |
response_format | object | 否 | - | - | 指定模型必须输出的格式的对象。设置为 { "type": "json_object" } 可启用 JSON 模式，保证模型生成的消息是有效的 JSON。 |
>response_format.type | string | 是 | text | text、json_object | 响应格式的类型。text 表示标准文本输出，json_object 表示 JSON 模式。 |
tools | array | 否 | - | - | 模型可能调用的工具列表。目前仅支持函数作为工具。使用此参数提供模型可能为其生成 JSON 输入的 函数列表。 |
>tools.type | string | 是 | - | function | 工具的类型。目前仅支持 function。 |
>tools.function | object | 是 | - | - | 函数定义。 |
>>tools.function.name | string | 是 | - | - | 要调用的函数名称。必须是 a-z、A-Z、0-9，或包含下划线和短横线，最大长度为 64。 |
>>tools.function.description | string | 否 | - | - | 函数功能的描述，供模型选择何时以及如何调用该函数。 |
>>tools.function.parameters | object | 否 | - | - | 函数接受的参数，以 JSON Schema 对象描述。 |
stream | boolean | 否 | false | true、false | 是否以增量方式流式返回响应。默认为 false。 |
响应示例
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1699896916,
"model": "qwen-turbo",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "I am a helpful AI assistant powered by Qwen."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 20,
"completion_tokens": 15,
"total_tokens": 35
}
}错误码
常见错误码
| 错误码 | 错误名称 | 描述 |
|---|---|---|
| 401 | Unauthorized | API 密钥缺失或无效 |
| 403 | Forbidden | 您的 API 密钥没有访问此资源的权限，或余额不足以执行请求的操作 |
| 429 | Too Many Requests | 您已超出速率限制 |
| 500 | Internal server error | 服务器内部错误 |
| 503 | Content policy violation | 内容因安全原因被阻止（实际状态码为 400） |
修改于 2026-03-11 06:24:05