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

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"
  ]
}