Get Task Status

• Query the execution status and result of an asynchronous task
• Real-time status updates and progress tracking
• Retrieve generation results when tasks are completed
• Multi-language support (zh/en/ko/ja)

GET /v1/tasks/{task_id}

cURL

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=en \
  --header 'Authorization: Bearer <token>'

200 - Image Generation Task

{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

cURL

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=en \
  --header 'Authorization: Bearer <token>'

200 - Image Generation Task

{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

Authorizations

Authorization · string · required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Path parameters

task_id · string · required

Task ID returned by the generation API

Query parameters

language · string

Language for response content, supports the following values:

• zh - Chinese
• en - English
• ko - Korean
• ja - Japanese

Defaults to English

Response

id · string

Unique task identifier

status · string

Task status values:

• pending - Queued for processing
• processing - In progress
• completed - Finished successfully
• failed - Failed
• cancelled - Cancelled by user

progress · integer

Task progress percentage (0–100)

result · object

Task result, returned only when status is completed

Show Properties

images · array

Array of generated image objects (for image generation tasks)

videos · array

Array of generated video objects (for video generation tasks)

thumbnail_url · string

Video thumbnail URL (for video generation tasks)

Important: This field is only returned when thumbnail generation is explicitly specified in the request parameters when creating the task. If thumbnail generation is not requested, this field will not be included in the response.

created · integer

Task creation timestamp

completed · integer

Task completion timestamp (only present when completed)

estimated_time · integer

Estimated completion time in seconds

actual_time · integer

Actual completion time in seconds (only present when completed)

error · object

Error details (only present when status is failed)

Show Properties

code · integer

Error code

message · string

Error message

type · string

Error type