Query Task Status

Query async task execution status and results by task_id.

Query Task Status

get

Query async task execution status and results by task_id. Task status flow: pending → processing → completed/failed. Recommended polling interval: 2-5 seconds. Stop polling when status is completed or failed. Image links are valid for 24 hours, download promptly.

Authorizations

BearerAuth

AuthorizationstringRequired

Authenticate using Bearer Token. Get API Key at https://viralapi.ai/api-key

Query parameters

task_idstringRequired

Task ID (from data.task_id returned by create task endpoint)

Example: task_nano-banana-pro_1765178625768

Responses

200

Query successful

application/json

create_timeinteger · int64Required

Task creation time (Unix timestamp, seconds)

Example: 1756817821

complete_timeinteger · int64Required

Task completion time (Unix timestamp, seconds), 0 when not completed

Example: 1763088308

task_typestring · enumRequired

Task type

Example: imagePossible values:

task_idstringRequired

Task ID

Example: task_nano-banana-pro_1765178625768

progressinteger · max: 100Required

Task progress percentage

Example: 100

modelstring · enumRequired

Model name used

Example: gemini-3-pro-image-previewPossible values:

statusstring · enumRequired

Task status: pending (queued), processing (generating), completed (finished), failed (failed)

Example: completedPossible values:

resultsstring · uri[]Required

Generated image URL array. Only contains valid URLs when status is completed. Links are valid for 24 hours.

Example: ["https://cdn.viralapi.ai/outputs/generated-image-1.png"]

400

Invalid request parameters

application/json

401

Authentication failed

application/json

402

Insufficient account balance

application/json

403

Insufficient permissions

application/json

404

Task not found or expired

application/json

500

Internal server error

application/json

502

Gateway error

application/json

get

/v1/task/query

HTTPcURLJavaScriptPython

GET /v1/task/query?task_id=text HTTP/1.1
Host: viralapi.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "create_time": 1756817821,
  "complete_time": 1763088308,
  "task_type": "image",
  "task_id": "task_nano-banana-pro_1765178625768",
  "progress": 100,
  "model": "gemini-3-pro-image-preview",
  "status": "completed",
  "results": [
    "https://cdn.viralapi.ai/outputs/generated-image-1.png"
  ]
}