# 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。 |
← 互動數字人