认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: qwen-plus-character
messages array 必填
表示角色扮演对话历史的消息对象数组
role
string必填消息角色
可选值:
user,assistant,system,developer
content
string | array必填文本字符串或多模态消息内容. 角色扮演场景可使用 system 或 developer 消息定义角色设定、语气和行为方式
max_tokens integer
生成的最大 token 数量
范围: 1 - 4096
temperature number
采样温度. 更高的值会让角色扮演回复更具变化
默认值: 1.0
范围: 0.0 - 2.0
top_p number
核采样参数
默认值: 1.0
范围: 0.0 - 1.0
stream boolean
是否增量流式返回响应
默认值: false
character_options object
角色扮演扩展参数. 该参数与 model、messages 同级, 用于传入角色人设、长期记忆、真实时间或知识库搜索配置
profile
string角色设定. 可用于替代或补充 system 消息中的人设描述
enable_realtime
boolean是否启用真实时间能力
默认值:
false
vector_store_ids
array知识库 ID 列表, 用于启用知识搜索
memory
object长期记忆配置. 开启长期记忆时需要同时传入会话 Header
x-dashscope-aca-session
响应格式
返回 OpenAI 兼容的 chat completion 对象, 包含生成的 assistant 消息和 token 用量.