# FAQ

Summary of frequently asked questions about platform usage

# Common Public Service Issues

# Sign Value Calculation Example for Third-Party System Integration

Example: The user-obtained appId is"c103af9ac77646ca9fb0122e75f30811"， appKey为"89f81a207e5e4a1297ed1255879191ee"。 Assuming the current time is1686730537，, the formula participating in the MD5 calculation should beMD5(c103af9ac77646ca9fb0122e75f30811168673053789f81a207e5e4a1297ed1255879191ee)，. The resulting 32-character lowercase value is"f6ffecf33d2073d9b3b93ba157665cfc"。

The request JSON should be

{
	"appId": "c103af9ac77646ca9fb0122e75f30811",
	"timestamp": "1686730537",
	"sign": "f6ffecf33d2073d9b3b93ba157665cfc",
	"grantType": "sign"
}

The accessToken in the returned result is the token used for access.

{ 
  "//first_comment":"omission",
  "accessToken": "ZGQ4OGQ0OGE0ZTgxMGE4ZjE1YWQ2ZjIzYWMwNTc5NWNkMGNjZmY0NC1iNTNlLTQyNmEtYmJjZS1lZGYyYWE2NmVmZjI",
  "//second_comment":"omission"
  
}

CURL request example

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 Call Example

After obtaining the authentication token, you need to include this token in the header of subsequent API requests. Place the token in the Authorization header field. CURL request example data-raw contains the specific business request content

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 Call Example

After obtaining the authentication token, you need to include this token in the header of subsequent API requests. Place the token in the Authorization header field or concatenate it in the URL. The token passed in the Header has higher priority. WebSocket service connection example

# HTTP Header Passing Example

In the handshake request of the WebSocket connection, pass the authentication token through the Authorization header. For example:

GET /api/voice/stream/v1 HTTP/1.1
Host: aigc.softsugar.com
Upgrade: websocket
Connection: Upgrade
Authorization: Bearer M2U2OTkyZjIyMjhiYjM5OGJjY2UyZWFmNTc5MTM0MTI0MThlYTBhMS04OWVjLTRmZjEtYjg2Ni1mMTM4YThkNjRmMTI&
Sec-WebSocket-Version: 13

# URL Concatenation Example

Browser or Postman

ws://aigc.softsugar.com/api/voice/stream/v1?Authorization=Bearer M2U2OTkyZjIyMjhiYjM5OGJjY2UyZWFmNTc5MTM0MTI0MThlYTBhMS04OWVjLTRmZjEtYjg2Ni1mMTM4YThkNjRmMTI&

In programming languages, spaces need to be URL-encoded

ws://aigc.softsugar.com/api/voice/stream/v1?Authorization=Bearer%20M2U2OTkyZjIyMjhiYjM5OGJjY2UyZWFmNTc5MTM0MTI0MThlYTBhMS04OWVjLTRmZjEtYjg2Ni1mMTM4YThkNjRmMTI&

# Task Errors and Solutions

Task Error Message	Solution
"code": 3333, "message": "请求参数为空或格式错误,请检查"	Please check whether the parameters are correctly passed and whether Content-Type is set correctly.
空或""	Please check whether the HTTP status is 401 Unauthorized, which indicates the lack of valid authentication credentials for the target resource.

# Common Video Synthesis Issues

# Task Errors and Solutions

Task Error Message	Solution
"errorMsg":"digital role model must must be in zip format and contain assets and models resources"	This error indicates that the avatar model file URL used in the video synthesis request is incorrect. Please check whether the avatar model file meets the requirements and whether there is a matching face_feature_id.
"errorMsg":"FfmpegTask: no pcm sound. taskId:b6c1b82ea3a54c1a9bf683c56a6d443d"	This error indicates that the avatar model used in the video synthesis request does not match the face_feature_id. Please check whether the avatar model and face_feature_id have a uniquely corresponding match in the system.
"errorMsg":"engine status error: failed, backend buffer size is too long"	This error indicates that in the video synthesis request, the TTS query content contains more than 80 consecutive characters without punctuation marks. Please check the readability of the query text content.
"errorMsg":[worker2d] FfmpegTask: process image info failed: output fps must be smaller than input fps.	This error indicates that the background video frame rate used in the video synthesis request does not meet the requirements. Background videos support MP4 format with a frame rate of 25 or above.

# Common Live Streaming Issues

# Task Errors and Solutions

Task Error Message	Solution
"errorMsg":"LiveStream：parse scenelist failed.pass video json to live？"	This error indicates that the input live streaming script JSON file is invalid and lacks required information. Please verify the script file format and check whether video synthesis input content was used for live stream creation. Additionally, note that the text content in the live streaming script must not be too short.

# Common Avatar Model Generation Issues

# Task Errors and Solutions

Task Error Message	Solution
"errorMsg":"docker exec gen_sucai_gpu_12 148fc1a251c549c0b72472fe26cb7fba_s1 is failed Error: Frame Index :7489 find 0 faces!"	The key phrase in this error is "7489 find 0 faces", meaning no faces were detected at frame 7489 of the video. Please check whether the content at that position in the video meets the requirements.
"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"	This error indicates that the video file used has no audio information. Please check whether the video meets the requirements.

# Common TTS Voice Model Generation Issues

# Task Errors and Solutions

Task Error Message	Solution
"errorMsg":"task is failed in stage: label"	The current version of TTS voice generation does not support manual labeling. The humanLabel field value needs to be set to false.

← Platform Capabilities