产品简介

产品概述

产品功能

产品优势

购买指南

价格指南

购买指引

使用代金券购买流程

退费说明

数智人形象介绍

形象类别介绍

基础形象库

形象和声音复刻指引

数智人平台操作指引

访问平台

形象生产与资产管理

数智人会话互动应用与管理

播报数智人视频生成与管理

运营管理与分析

服务端 API 接入

数智人 API 接入模式概述

数智人 aPaas 接口调用方式

2D真人小样本形象、声音定制 API 文档

视频生成服务 API 文档

交互数智人服务 API 文档

个人资产管理 API 文档

客户端 SDK 接入

整体介绍

3D 端渲染 SDK 接入

2D 端渲染 SDK 接入

数智人 SSML 标记语言规范

接口对接常见问题

PDF

聚焦模式

字号

最后更新时间： 2024-07-18 18:23:05

﻿
问题描述
解决方式
备注
调用接口时出现鉴权不通过
1. 确认签名时参数按照字典序排列了
2. 确认时间戳参数为当前时间
3. 参考右侧的示例参数，按照自己的签名步骤计算一下，如果计算结果与示例一致则表示签名计算步骤无误。
参数：
appkey = e38267c0e86411ebb02aed82acb0ed99
accesstoken = f68f2d10ae9e4604b76fb05cf46bccec
timestamp=1646636485
签名结果：BfWuaC9kmaicCggXc693uK%2BsZQ8qe88O4HVQNTdwZuo%3D
﻿
调用接口出现参数错误
1. 请确认请求的 body 是否加了 header 参数，不加的话会报错。如右图所示。
2. 参数的类型要严格按照接口文档中填充。
﻿
﻿
﻿
﻿
查询出的形象数量不对或查询不到形象
如果开通的是小样本形象需要参考 分页查询小样本形象列表接口查询。
如果开通的是2d精品形象需要参考 客户资源查询主播接口查询。
说明：
官网下单播报小时包后，开通的形象既有2d小样本，又有2d精品，需要参考两套接口分别查询相关形象。
﻿
﻿
是否支持生成透明背景的视频
支持，可以生成 webm 格式的带透明通道的视频
﻿
﻿
为什么 webm 透明背景的视频播放出来是绿幕的
说明客户使用的播报器不支持 webm 格式，可以在 Chrome 中播放看看，如果出来的视频是黑底的，说明视频本身没问题。
﻿
形象位置参数调整后不生效
1. 确认调用的接口是基础版还是进阶版，只有进阶版接口支持。
2. 确认视频输出格式是否为 GreenScreenMp4，设置为该值时不支持调整位置。
﻿
主播位置计算方法
﻿
﻿
﻿
﻿
如何计算数智人初始大小
数智人查询接口中会返回OriginZoom(原始缩放系数)和PoseImage(数智人姿态图片)，OriginZoom 乘以 PoseImage的宽高即为数智人初始大小。
﻿
文案中插入动作不生效
动作前后需要预留一定的文字，每个动作对预留文字都不一样，建议前后预留10个字以上。
﻿
数智人是否支持调整语速，韵律，多音字
可以，参考接口文档中的ssml标签附录二： SSML 规范部分。
﻿
指定了外部的S3存储，数智人视频未上传上去
请检查S3的权限设置是否允许外部写入，或者参数中的S3链接是否带入了鉴权信息。
﻿
没有字幕文件
只有文本驱动才有字幕文件，声音驱动没有
﻿
超过配额限制: 提交音频制作数量超过限制：1
开通权限时默认只开通1路音频制作并发，即同时只能有一个音频任务处于制作中，必须等上一个制作完成后才能提交下一个任务。可以通过购买音频并发解决。
﻿
超过配额限制: 提交视频制作数量超过限制：n
1. 针对每种形象类型，每个用户默认支持同时处理5个视频制作任务，由主子账号共享。这5个任务使用的并发资源所有客户共享，可能会出现任务排队的情况。
2. 可增购播报独享并发，例如购买了1路播报独享并发，则一共支持同时处理6个视频制作任务。增购的并发由该用户专享。
﻿
该问题解决方案：
1.  用户增加任务排队策略；
2.  购买独享并发。
﻿
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

腾讯云智能数智人

接口对接常见问题

帮助和支持

问题描述	解决方式	备注
调用接口时出现鉴权不通过	1. 确认签名时参数按照字典序排列了 2. 确认时间戳参数为当前时间 3. 参考右侧的示例参数，按照自己的签名步骤计算一下，如果计算结果与示例一致则表示签名计算步骤无误。	参数： appkey = e38267c0e86411ebb02aed82acb0ed99 accesstoken = f68f2d10ae9e4604b76fb05cf46bccec timestamp=1646636485 签名结果：BfWuaC9kmaicCggXc693uK%2BsZQ8qe88O4HVQNTdwZuo%3D
调用接口出现参数错误	1. 请确认请求的 body 是否加了 header 参数，不加的话会报错。如右图所示。 2. 参数的类型要严格按照接口文档中填充。
查询出的形象数量不对或查询不到形象	如果开通的是小样本形象需要参考分页查询小样本形象列表接口查询。如果开通的是2d精品形象需要参考客户资源查询主播接口查询。说明：官网下单播报小时包后，开通的形象既有2d小样本，又有2d精品，需要参考两套接口分别查询相关形象。
是否支持生成透明背景的视频	支持，可以生成 webm 格式的带透明通道的视频
为什么 webm 透明背景的视频播放出来是绿幕的	说明客户使用的播报器不支持 webm 格式，可以在 Chrome 中播放看看，如果出来的视频是黑底的，说明视频本身没问题。
形象位置参数调整后不生效	1. 确认调用的接口是基础版还是进阶版，只有进阶版接口支持。 2. 确认视频输出格式是否为 GreenScreenMp4，设置为该值时不支持调整位置。
主播位置计算方法
如何计算数智人初始大小	数智人查询接口中会返回OriginZoom(原始缩放系数)和PoseImage(数智人姿态图片)，OriginZoom 乘以 PoseImage的宽高即为数智人初始大小。
文案中插入动作不生效	动作前后需要预留一定的文字，每个动作对预留文字都不一样，建议前后预留10个字以上。
数智人是否支持调整语速，韵律，多音字	可以，参考接口文档中的ssml标签附录二： SSML 规范部分。
指定了外部的S3存储，数智人视频未上传上去	请检查S3的权限设置是否允许外部写入，或者参数中的S3链接是否带入了鉴权信息。
没有字幕文件	只有文本驱动才有字幕文件，声音驱动没有
超过配额限制: 提交音频制作数量超过限制：1	开通权限时默认只开通1路音频制作并发，即同时只能有一个音频任务处于制作中，必须等上一个制作完成后才能提交下一个任务。可以通过购买音频并发解决。
超过配额限制: 提交视频制作数量超过限制：n	1. 针对每种形象类型，每个用户默认支持同时处理5个视频制作任务，由主子账号共享。这5个任务使用的并发资源所有客户共享，可能会出现任务排队的情况。 2. 可增购播报独享并发，例如购买了1路播报独享并发，则一共支持同时处理6个视频制作任务。增购的并发由该用户专享。该问题解决方案： 1. 用户增加任务排队策略； 2. 购买独享并发。