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

{
  "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 --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=en \
  --header 'Authorization: Bearer <token>'

{
  "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 authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd 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
โ€‹
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)