Skip to main content
GET
/
api
/
v3
/
contents
/
generations
/
tasks
/
{task_id}
Query Task Copy
curl --request GET \
  --url https://gptproto.com/api/v3/contents/generations/tasks/{task_id} \
  --header 'Authorization: <authorization>'
{
  "error": {
    "message": "Invalid task_id format",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

​
Overview

Query the status and result of a video generation task created by the seedance-1-0-pro-250528 model. This endpoint allows you to check if the video generation is complete and retrieve the video URL.

​
Authentication

This endpoint requires authentication using a Bearer token with your API key.
​
Authorization
string
required
Your API key in the format: Bearer YOUR_API_KEY

​
Path Parameters

​
task_id
string
required
The task ID returned when creating the video generation task

​
Request Example

curl -X GET "https://gptproto.com/api/v3/contents/generations/tasks/{task_id}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Success - Pending
200
Task is still processing
{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_xxxxxxxxxx",
    "status": "pending",
    "model": "seedance-1-0-pro-250528"
  }
}
​
Success - Completed
200
Task completed successfully with video URL
{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_xxxxxxxxxx",
    "status": "completed",
    "model": "seedance-1-0-pro-250528",
    "video_url": "https://example.com/generated_video.mp4",
    "created_at": "2025-01-10T12:00:00Z",
    "completed_at": "2025-01-10T12:01:30Z"
  }
}
​
Success - Failed
200
Task failed with error message
{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_xxxxxxxxxx",
    "status": "failed",
    "model": "seedance-1-0-pro-250528",
    "error": "Content policy violation or generation error"
  }
}

​
Error Responses

{
  "error": {
    "message": "Invalid task_id format",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}