GEgenaipro
GTMage-2.5

Get Task Status

Changed on

Poll the status of an image generation task (any GTMage-2.5 model). Use the task ID returned from POST /v2/gt-mage/create-image.

Status values

StatusDescription
processingTask is being processed
completedDone — file_urls contains the generated images
failedError — see error field for details. Credits are automatically refunded

Rate limit: 120 requests/minute per account, across all tasks. Prefer callback_url or the gt_mage_task_updated WebSocket event when you only need the final state.

get/v2/gt-mage/tasks/{id}

Request

Path parameters

idstring required

Task ID received from the create endpoint

Response

Task status

idstring

Task ID

promptstring

The prompt used for generation

file_urlsstring[]

URLs of the generated files (empty while processing). Public; deleted about 90 days after creation (then 404) — download them yourself.

status'processing' | 'completed' | 'failed'

Task status

errorstring

Error message — present when status is failed, or when status is completed but some videos failed (see failed_slots)

modelstring

GTMage-2.5 tasks: gtmage-2.5, or <model>-<quality>-<resolution> for Sunburst / Flare (e.g. gtmage-2.5-sunburst-high-2k)

aspect_ratiostring

GTMage-2.5 tasks: the requested size

created_atstring date-time

Timestamp when the task was created

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "A cat walking on the beach at sunset",
  "file_urls": []
}

Changes

  • 8e065c159192Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 3283eccf9421Revision changes
    • info

      api operation id getChatgptImageTask removed and replaced with getGtMageTask

    • info

      api tag GTMage-2.5 added

    • info

      api tag ChatGPT Image removed