认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY模型说明
qwen3.8-max 是新的 Qwen Max 系列模型. 对比当前已有的 qwen3.7-max 文档, 这次最主要的参数变化是生成上限从 65536 提升到 131072 output tokens. 阿里云文档中给出的上下文长度为 1000000, 最大输入长度为 991808, 思考模式最大输入长度为 983616, 思考模式最大输出长度为 131072, 最大思维链长度为 262144.
能力上支持文本、图片、视频输入, 文本输出, function calling, structured output, 前缀续写, 上下文缓存, 以及上游地域支持时的联网搜索.
参数
model string 必填
请求使用的模型 ID
值: qwen3.8-max
messages array 必填
表示对话历史的消息对象数组
role
string必填消息角色
可选值:
user,assistant,system,developer
content
string | array必填消息内容. 纯文本请求使用字符串; 当选择的线路支持多模态输入时, 可使用文本、图片、视频内容数组
max_tokens integer
生成的最大 token 数量. 具体上游开启思考时, 思考 token 可能与生成 token 共用该预算.
范围: 1 - 131072
temperature number
采样温度
默认值: 1.0
范围: 0.0 - 2.0
top_p number
核采样参数
默认值: 1.0
范围: 0.0 - 1.0
stream boolean
是否增量流式返回响应
默认值: false
tools array
模型可调用的工具列表, 使用 OpenAI function tool 结构. 当路由上游支持 function calling 时使用.
type
string必填工具类型
值:
function
function
object必填函数定义, 包含
name, 可选的description, 以及 JSON Schemaparameters
tool_choice string | object
控制模型如何选择工具
可选值: none, auto, required, 或指定某个 function 的对象
默认值: auto
response_format object
模型必须输出的格式. 当路由模型支持结构化输出时可使用
type
string必填输出格式类型
可选值:
text,json_object,json_schema
响应格式
id string
completion 的唯一标识符
object string
对象类型, 始终为 chat.completion
created integer
创建 completion 时的 Unix 时间戳
model string
用于 completion 的模型
choices array
completion 结果列表
index
integer结果索引
message
object生成的消息
role
string消息角色, 始终为
assistantcontent
string生成的文本内容
finish_reason
string模型停止生成的原因
usage object
token 使用统计
prompt_tokens
integer提示词 token 数
completion_tokens
integer生成 token 数
total_tokens
integertoken 总数