检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API和SDK使用 如何获取项目ID？ 如何调用MetaStudio接口？ Flexus支持通过API集成使用吗？ 为什么调用API时提示“APIG.0301”？ 使用API时返回“APIGW”开头的错误码，该如何处理？ 智能交互SDK从哪里下载？
如何自定义域名方式访问智能交互页面？ 用户与数字人进行智能交互的URL页面，默认为IP地址形式。如果用户希望通过域名访问，目前MetaStudio服务提供了A记录的域名，但是这些A记录域名不能在浏览器直接访问，需要用户自己申请备案一个域名，并通过CNAME方式解析到如下域名上。 华
为什么调用API时提示“APIG.0301”？ 调用API时提示“APIG.0301”，可能有以下两个原因： 提示"error_msg":"Incorrect IAM authentication information: verify aksk signature fail","error_code":"APIG
使用API时返回“APIGW”开头的错误码，该如何处理？ 当您使用云服务API，遇到“APIGW”开头的错误码，请参考错误码说明进行处理。 父主题： API和SDK使用
Flexus支持通过API集成使用吗？ 支持，详见接口创建分身数字人模型训练任务的is_flexus字段。 父主题： API和SDK使用
API概览 华为云MetaStudio服务对应的接口列表如下所示，在调用API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用API请参考应用示例。 数字资产管理 表1 数字资产管理接口 接口 说明 POST /v1/{project_id}/digital-assets
如何调用API 构造请求 认证鉴权 返回结果
数字内容生产线服务对服务端API设置了调用次数限制，避免出现短时间内重复调用API，服务中断的情况。 如果调用API时，返回“APIGW.0308”错误信息，是触发了API流控限制。需要参考下述表格中的流控值，调整调用API的间隔时间，控制请求的发送速度；或者等待一段时间后，再发送API请求。 “
如何获取项目ID？ 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中“我的凭证”。 图1 管理控制台 在“API凭证”页面的项目列表中查看项目ID。 图2 获取项目ID 父主题： API和SDK使用
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口，您可以从接口的请求部分看到所需的请求参数及参数
如何调用MetaStudio接口？ MetaStudio提供RESTful API和Java/Python/Go三种语言的SDK。API调用请参考《API参考》，SDK集成请参考API Explorer中的“代码示例”。 父主题： API和SDK使用
接口参考 主入口（HwICSUiSdk） 事件通知（EventMap） 错误码（ICSError） 授权浏览器麦克风的访问权限 Web语音唤醒 父主题： Web SDK
智能交互业务媒体流如何应对防火墙限制？ 分身数字人智能交互业务使用SparkRTC方式收流，其信令和媒体访问方式为“IP+端口”或“域名+端口”，您的防火墙需要配置SparkRTC端口和域名的白名单，请参考直播业务媒体流如何应对防火墙限制？。 父主题： 智能交互
直播业务媒体流如何应对防火墙限制？ 分身数字人直播业务使用SparkRTC方式收流，其信令和媒体访问方式为“IP+端口”或“域名+端口”，防火墙需要放开如下限制： 解除所有IP访问的限制。 在客户端防火墙配置SparkRTC端口和域名白名单。 配置SparkRTC端口的防火墙白名单，如表1所示。 表1
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
语音同步合成WebSocket接口 前提条件 本接口目前仅支持“华北-北京四”和“华东-上海一”区域使用，且必须提交工单申请开通后才能使用。 使用本接口前，需要在MetaStudio控制台服务概览页面，开通“声音合成”的按需计费。 详细操作为：单击“声音合成”卡片中的“去开通”，
智能交互驱动WebSocket接口 终端节点获取方式 智能交互驱动WebSocket接口终端节点的获取方式，如表1所示。 表1 终端节点获取方式 场景 获取方式 未通过WEB SDK调用场景 终端节点地址从接口StartSmartChatJob.xml的响应参数chat_access_address中获取。
对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。
100vw;height: 100vh"></div> 创建智能交互任务。具体接口详情，请参见create。 1 2 3 4 5 6 HwICSUiSdk.create({ serverAddress: 'metastudio-api.cn-north-4.myhuaweicloud.com'
前提条件 需要申请开通智能交互权限后，才可集成智能交互SDK使用。 WebSDK使用限制 由于浏览器的安全策略限制，仅支持通过“https://域名”方式访问，否则无法正常加载运行智能交互WebSDK。 父主题： 智能交互客户端SDK
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
