# FAQ
平台使用常见问题解答汇总
# 公共服务常见问题
# 三方系统接入中sign值计算示例
例：用户获得的appId为"c103af9ac77646ca9fb0122e75f30811"， appKey为"89f81a207e5e4a1297ed1255879191ee"。 假设当前时间为1686730537，那么参与MD5计算的公式应为MD5(c103af9ac77646ca9fb0122e75f30811168673053789f81a207e5e4a1297ed1255879191ee)，计算后32位小写值为"f6ffecf33d2073d9b3b93ba157665cfc"。
请求json应为
{
"appId": "c103af9ac77646ca9fb0122e75f30811",
"timestamp": "1686730537",
"sign": "f6ffecf33d2073d9b3b93ba157665cfc",
"grantType": "sign"
}
返回结果中accessToken即为访问所使用的token。
{
"//first_comment":"omission",
"accessToken": "ZGQ4OGQ0OGE0ZTgxMGE4ZjE1YWQ2ZjIzYWMwNTc5NWNkMGNjZmY0NC1iNTNlLTQyNmEtYmJjZS1lZGYyYWE2NmVmZjI",
"//second_comment":"omission"
}
CURL请求示例
curl --location --request POST 'https://aigc.softsugar.com/api/uc/v1/access/api/token' \
--header 'Content-Type: application/json' \
--data '{
"appId": "c103af9ac77646ca9fb0122e75f30811",
"timestamp": "1686730537",
"sign": "f6ffecf33d2073d9b3b93ba157665cfc",
"grantType": "sign"
}'
# HTTP接口调用示例
获取认证令牌后，你需要在后续的API请求头部中包含此令牌。将令牌放置在Authorization头部字段中。 CURL请求示例 data-raw中为具体业务请求内容
curl --location --request POST 'https://aigc.softsugar.com/api/2dvh/v1/xxx/yyy/zzz' \
--header 'Authorization: Bearer YWI1NGE4ZDVhYmM2MTZjMDA0Y2UxZDAwMjdhODk4Mzk4NWUwYTdmOS02ZDM0LTQxNmQtYTAwMi1mMDg0MDAzNGNlZWY' \
--header 'Content-Type: application/json' \
--data-raw '{ }'
# WebSocket接口调用示例
获取认证令牌后，你需要在后续的API请求头部中包含此令牌。将令牌放置在Authorization头部字段中或者在URL中拼接，Header中传递的token具有更高优先级。 WebSocket服务连接示例
# HTTP Header中传递示例
在WebSocket连接的握手请求中，通过Authorization头部传递认证令牌。例如：
GET /api/voice/stream/v1 HTTP/1.1
Host: aigc.softsugar.com
Upgrade: websocket
Connection: Upgrade
Authorization: Bearer M2U2OTkyZjIyMjhiYjM5OGJjY2UyZWFmNTc5MTM0MTI0MThlYTBhMS04OWVjLTRmZjEtYjg2Ni1mMTM4YThkNjRmMTI&
Sec-WebSocket-Version: 13
# URL中拼接示例
浏览器或postman
ws://aigc.softsugar.com/api/voice/stream/v1?Authorization=Bearer M2U2OTkyZjIyMjhiYjM5OGJjY2UyZWFmNTc5MTM0MTI0MThlYTBhMS04OWVjLTRmZjEtYjg2Ni1mMTM4YThkNjRmMTI&
开发语言的中需要对空格编码
ws://aigc.softsugar.com/api/voice/stream/v1?Authorization=Bearer%20M2U2OTkyZjIyMjhiYjM5OGJjY2UyZWFmNTc5MTM0MTI0MThlYTBhMS04OWVjLTRmZjEtYjg2Ni1mMTM4YThkNjRmMTI&
# 任务报错及应对方法
| 任务报错信息 | 处理方式 |
|---|---|
| "code": 3333, "message": "请求参数为空或格式错误,请检查" | 请检查是否正确传入了参数以及Content-Type是否设置正确。 |
| 空或"" | 请检查http status是否为401 Unauthorized，该返回表示缺乏目标资源要求的身份验证凭证。 |
# 视频合成常见问题
# 任务报错及应对方法
| 任务报错信息 | 处理方式 |
|---|---|
| "errorMsg":"digital role model must must be in zip format and contain assets and models resources" | 该错误表示视频合成请求中使用的人物模型文件url内容不正确，请检查人物模型文件是否符合要求，以及是否有匹配的face_feature_id。 |
| "errorMsg":"FfmpegTask: no pcm sound. taskId:b6c1b82ea3a54c1a9bf683c56a6d443d" | 该错误表示视频合成请求中使用的人物模型与face_feature_id不匹配，请检查使用的人物模型与face_feature_id是否在系统中是唯一对应的匹配关系。 |
| "errorMsg":"engine status error: failed, backend buffer size is too long" | 该错误表示视频合成请求中单个TTS 的query内容中连续多个字(80字以上)没有出现标点符号，请检查query 文本内容的可读性。 |
| "errorMsg":[worker2d] FfmpegTask: process image info failed: output fps must be smaller than input fps. | 该错误表示视频合成请求中使用的背景视频帧率不符合要求，背景视频支持mp4格式，帧率要求 25 以上。 |
# 直播常见问题
# 任务报错及应对方法
| 任务报错信息 | 处理方式 |
|---|---|
| "errorMsg":"LiveStream：parse scenelist failed.pass video json to live？" | 该错误表示请求输入的直播脚本json文件不合法，缺少必要信息，请确认脚本文件格式，以及判断是否使用了视频合成的输入内容用于直播创建。此外还需注意直播脚本中的文字数量不可过少。 |
# 人物模型生成常见问题
# 任务报错及应对方法
| 任务报错信息 | 处理方式 |
|---|---|
| "errorMsg":"docker exec gen_sucai_gpu_12 148fc1a251c549c0b72472fe26cb7fba_s1 is failed Error: Frame Index :7489 find 0 faces!" | 该错误关键字为"7489 find 0 faces"，释义为该视频7489帧没有检测到人脸，请检查视频中该位置是否符合要求。 |
| "errorMsg":"d8fcc266be74463286ff8bf06df13367_s1 input_source.mp4 [Errno 2] No such file or directory: '/data/task/d8fcc266be74463286ff8bf06df13367_s1//av_check_res/input_source.mp4/audio_summary.json', video_summary or audio_summary not exit" | 该错误表示使用的视频文件无音频信息，请检查视频是否符合要求。 |
# TTS音色模型生成常见问题
# 任务报错及应对方法
| 任务报错信息 | 处理方式 |
|---|---|
| "errorMsg":"task is failed in stage: label" | 当前版本TTS音色生成不支持人工标注，需要将humanLabel字段取值置为false。 |
← 互动数字人