从模板创建自定义角色

更新时间：2026-02-26 09:15:22LLM 副本以 Markdown 格式查看下载 PDF

本文介绍从模板创建自定义角色的 API。

接口描述

根据设备 ID，按照 AI 智能体角色模板创建自定义角色。

接口地址

POST: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/custom-roles/from-template

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID

body 说明

参数名	类型	参数位置	是否必填	说明
template_id	String	body	true	模板 ID
role_name	String	body	true	角色名称
role_desc	String	body	false	角色描述
role_introduce	String	body	true	角色介绍
role_img_url	String	body	true	角色图片 URL
use_lang_code	String	body	true	使用的语言代码
use_timbre_id	String	body	true	使用的音色 ID
use_llm_id	String	body	true	使用的 LLM ID
speed	String	body	false	语速
need_bind	String	body	false	是否直接绑定已创建的角色

返回参数

参数名	类型	说明
result	boolean	操作是否成功

请求示例

POST: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/custom-roles/from-template

{
  "device_id": "6c3585ebfe301b40a8u***",
  "template_id": "94300***",
  "role_name": "从模板创建的***",
  "role_desc": "描述***",
  "role_introduce": "你是一名天文学家，你有着丰富的知识储备，你善于激发孩子对太空的好奇心和兴趣。***",
  "role_img_url": "https://images.tuyacn.com/***/icon/2***.png",
  "use_lang_code": "zh",
  "use_llm_id": "8*",
  "use_timbre_id": "6*",
  "speed": "30",
  "need_bind": true
}

返回示例

{
    "tid": "6fa034fc1a6d11f0a8212220de940dcb",
    "result": true,
    "t": 1744771778112,
    "success": true
}

错误码

参考错误码。