Skip to main content
GET
Retrieve task
After submitting an asynchronous image task, use the returned public task_id to retrieve its status. Public task IDs use the task_ prefix; the image pool’s internal img_ ID cannot be used for retrieval.

Request

In-progress response

Successful response

Image URL formats

After the task succeeds, read data.data[].url. The outer data is the saved generation response, and its data field contains the image records. If the URL starts with /p/img/, prefix it with https://lmage2.dimilinks.com before displaying or downloading it. A complete https://lmage2.dimilinks.com/p/img/... URL can be used directly; its signature and expiration are embedded, so no Bearer token is required.

Failed response

Status values

Use only GET /v1/tasks/{task_id} for image task retrieval. Do not call the removed /v1/images/tasks/{task_id} route or treat an internal img_xxx image ID as the public task ID.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

task_id
string
required

Response

Image or video task

task_id
string
required
Example:

"task_xxx"

status
enum<string>
required
Available options:
NOT_START,
SUBMITTED,
QUEUED,
IN_PROGRESS,
SUCCESS,
FAILURE
progress
string
required
Pattern: ^[0-9]{1,3}%$
Example:

"50%"

created_at
integer
required
platform
string
Example:

"openai"

fail_reason
string
finished_at
integer
data
object