Skip to main content
GET
Query Task Status

Authorizations

Authorization
string
header
required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Path Parameters

task_id
string
required

Task ID, ignore {} when querying, append the id from the async task response body at the end of the path

Response

Task status details

created
integer

Task creation timestamp

Example:

1756817821

id
string

Task ID

Example:

"task-unified-1756817821-4x3rx6ny"

model
string

Model used

Example:

"gemini-3.1-flash-image-preview"

object
enum<string>

Task type

Available options:
image.generation.task,
video.generation.task,
audio.generation.task
Example:

"image.generation.task"

progress
integer

Task progress percentage

Required range: 0 <= x <= 100
Example:

100

results
string<uri>[]

Task result list (provided when completed)

Example:
status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"completed"

error
object | null

Error information when the task fails (only present when status is "failed"). Note: error.code here is a string-type business error code, different from HTTP status codes. See the Error Codes Reference for the complete list.

task_info
object

Task detailed information

type
enum<string>

Task type

Available options:
image,
video,
audio,
text
Example:

"image"