v1
latestOpenAPI 3.0.32026-07-241112213.6 KBQuery Task
Query the status and output of a Storyboard image generation task by taskId. images is empty or in progress while the task is unfinished; on success, returns the generated storyboard grid image fileId and access URL.
Status: Unfinished tasks return running; finished tasks return success or fail.
Credits: costCredit is the actual credit consumed; updated after task success.
get/v1/common_task/storyboard/task/query
Query parameters
taskIdstring required
Task ID returned from the submit API
needCloudFrontUrlboolean
When true, images[].filePath prefers CloudFront CDN URLs; default false returns S3 URLs
Headers
Topview-Uidstring required
User ID; must match the task owner
Authorizationstring required
API key for authentication. Format: Bearer {apiKey}
Response
Query successful
Example response
{
"code": "200",
"message": "Success",
"result": {
"taskId": "6f4b5a8c9d0e1f2a3b4c5d6",
"status": "success",
"costCredit": 1,
"images": [
{
"fileId": "output_file_id",
"filePath": "https://cdn.example.com/storyboard.png",
"width": 1920,
"height": 1080
}
]
}
}