Skip to main content
GET
Get Task Details
Query the status and results of any task created in the whollyapi models. This is a unified query interface that works with all models under the image to video category.

Supported Models

This endpoint works with all Image-to-Video models in the Market, including:
  • Seedance: Seedance-2.0, Seedance-1.5-Pro, and related image to video models
  • Grok Imagine: image-to-video
  • Kling: image-to-video models

Task States

Best Practices

  • Download results immediately: Generated content URLs typically expire after 24 hours.

Query Parameters

string
required
The unique task identifier returned when you created the task.Example: task_12345678

Authentication

All API requests require a Bearer Token. Add your API key to the request:

Response

A successful request returns a 200 response containing the task status, task metadata, generated results, timing information, and credit consumption details.

Response schema

integer
Response status code.Allowed values:
string
Response message. Contains the error description when the request fails.Example: success
object
required
The task data object containing all task information.

Task data

string
required
The unique identifier for this task.Example: task_12345678
string
The model used for this task.
string
Current state of the task.Allowed values:
  • waiting
  • queuing
  • generating
  • success
  • fail
Example: success
string
A JSON string containing the original request parameters used to create the task.
string
A JSON string containing the generated result. This field is only available when the task state is success.
string
Error code if the task failed. Returns an empty string if the task succeeds.
string
Error message if the task failed. Returns an empty string if the task succeeds.
integer
Processing time in milliseconds. Available when the task is successful.Example: 15000
integer
Completion timestamp as a Unix timestamp in milliseconds.Example: 1698765432000
integer
Creation timestamp as a Unix timestamp in milliseconds.Example: 1698765400000
integer
Update timestamp as a Unix timestamp in milliseconds.Example: 1698765432000
integer
Generation progress from 0 to 100.This field is only returned when the model is sora2 or sora2 pro.Example: 45
number
The actual number of credits deducted during task execution.

Result formats

The structure of data.resultJson depends on the output type and model.

media, and videos

For videos, resultJson has the following structure:

Seedance 2 and Seedance 2 Fast

When return_last_frame is enabled:

Text output

For text output:
URLs returned by the subject detection model are valid for 1 hour.

Example response

HTTP error responses

The request could not be processed due to invalid input.
Authentication credentials are missing or invalid.
The requested resource or endpoint does not exist.
The request parameters failed validation checks.
The request limit has been exceeded for this resource.
An unexpected error occurred while processing the request.