跳转到主要内容
GET
https://api.apimart.ai
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url 'https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=zh' \
  --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=zh' \
  --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
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY

Path parameters

task_id
string
required
生成API返回的任务ID

Query parameters

language
string
返回内容的语言,支持以下值:
  • zh - 中文
  • en - 英文
  • ko - 韩文
  • ja - 日文
默认返回英文

Response

id
string
任务唯一标识符
status
string
任务状态值:
  • pending - 排队等待处理
  • processing - 处理中
  • completed - 成功完成
  • failed - 失败
  • cancelled - 用户取消
progress
integer
任务进度百分比(0–100)
result
object
任务结果,仅在状态为 completed 时返回
created
integer
任务创建时间戳
completed
integer
任务完成时间戳(仅在完成时存在)
estimated_time
integer
预计完成时间(秒)
actual_time
integer
实际完成时间(秒)(仅在完成时存在)
error
object
错误详情(仅在状态为 failed 时存在)