Skip to content

#Task query

Query task ​

http
GET /v1/tasks/{id}

Returned task object:

FieldDescription
idTask ID
capabilityCapabilities, such as image.pose
statusStatus, see table below
template_idTemplate used
idempotency_keyThe Idempotency-Key passed in when creating was not passed as null
costFor the points of this task (actually deducted after success), see Billing and Points
outputValue when successful: { "images": [image URL] }
errorValue on failure: { "code", "message" }
created_at / started_at / finished_atCreation, start, end time (UTC)
StatusMeaning
queuedQueuing
runningGenerating
succeededSuccess
failedFailed

It is recommended to query every 3 to 5 seconds until the status is succeeded or failed. Tasks that are not completed for more than 15 minutes will be judged as failed.

The resulting images will be cleaned regularly, please download and save them in time.

Task list ​

http
GET /v1/tasks?page=1&pageSize=20&status=succeeded
json
{ "data": [], "total": 42, "page": 1, "page_size": 20 }
Copyright © 2026 ModelGo all rights reserved | Technology powered by MoneyGo.ai