跳转到主要内容
GET
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task-unified-1757156493-k9m2xpvw",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": "https://example.com/generated-image.png",
          "expires_at": 1757242893
        }
      ]
    },
    "created": 1757156493,
    "completed": 1757156593,
    "estimated_time": 100,
    "actual_time": 100
  }
}
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task-unified-1757156493-k9m2xpvw",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": "https://example.com/generated-image.png",
          "expires_at": 1757242893
        }
      ]
    },
    "created": 1757156493,
    "completed": 1757156593,
    "estimated_time": 100,
    "actual_time": 100
  }
}

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

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 时存在)