查询任务 - Max API

curl --request GET \
  --url https://api.maxapi.io/api/v1/task/9db7d1ed-d1e5-4d11-9f3a-61f653b905ad \
  --header 'Authorization: Bearer <token>'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "SUCCESS",
    "input": {
      "model": "nano-banana",
      "prompt": "赛博朋克风格的东京街景",
      "ratio": "16:9",
      "resolution": "2k"
    },
    "result": {
      "type": "image",
      "urls": [
        "https://example.com/output/image1.png",
        "https://example.com/output/image2.png"
      ]
    },
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:55:04.039815Z"
  }
}

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "PROCESSING",
    "input": {
      "model": "nano-banana",
      "prompt": "赛博朋克风格的东京街景"
    },
    "result": null,
    "failure_reason": null,
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:48.000000Z"
  }
}

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "FAILURE",
    "input": {
      "model": "veo3",
      "prompt": "..."
    },
    "result": null,
    "failure_reason": "INVALID_PARAMETERS",
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:55.000000Z"
  }
}

{
  "code": 404,
  "msg": "task not found"
}

GET

api

task

{taskId}

curl --request GET \
  --url https://api.maxapi.io/api/v1/task/9db7d1ed-d1e5-4d11-9f3a-61f653b905ad \
  --header 'Authorization: Bearer <token>'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "SUCCESS",
    "input": {
      "model": "nano-banana",
      "prompt": "赛博朋克风格的东京街景",
      "ratio": "16:9",
      "resolution": "2k"
    },
    "result": {
      "type": "image",
      "urls": [
        "https://example.com/output/image1.png",
        "https://example.com/output/image2.png"
      ]
    },
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:55:04.039815Z"
  }
}

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "PROCESSING",
    "input": {
      "model": "nano-banana",
      "prompt": "赛博朋克风格的东京街景"
    },
    "result": null,
    "failure_reason": null,
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:48.000000Z"
  }
}

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "FAILURE",
    "input": {
      "model": "veo3",
      "prompt": "..."
    },
    "result": null,
    "failure_reason": "INVALID_PARAMETERS",
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:55.000000Z"
  }
}

{
  "code": 404,
  "msg": "task not found"
}

根据 taskId 查询任务的当前状态和生成结果。

taskId

string

required

提交任务时返回的任务 ID。

响应字段

code

integer

状态码，0 表示成功。

data

object

Show properties

taskId

string

任务 ID。

status

string

任务状态：PENDING、PROCESSING、SUBMITTED、SUCCESS、FAILURE、TIMEOUT、CANCELLED。

input

object

提交时的完整输入参数（包含 model）。

result

object

任务结果，仅在 SUCCESS 时有值，其他终态为 null。

Show properties

type

string

结果类型：image 或 video。

urls

string[]

生成资源的 URL 列表。图片可能多张，视频通常 1 个。

文件链接有效期为 7 天，请及时下载保存。

failure_reason

string | null

机器可读的失败分类，始终存在；无特定可操作原因时为 null。

值	含义	建议处理方式
`CONTENT_MODERATION`	Prompt 或图片因包含真人人脸、受版权保护的人物或公众人物，或 NSFW 内容而被拒绝	告知用户内容违规；不要重试
`INVALID_PARAMETERS`	传入参数不正确	修正请求参数后再提交；不要直接重试
`INSUFFICIENT_POINTS`	账户积分不足	引导用户充值；不要重试
`null`	无特定可操作原因	视情况可重试

created_at

string

任务创建时间（ISO 8601）。

updated_at

string

任务最后更新时间（ISO 8601）。

curl --request GET \
  --url https://api.maxapi.io/api/v1/task/9db7d1ed-d1e5-4d11-9f3a-61f653b905ad \
  --header 'Authorization: Bearer <token>'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "SUCCESS",
    "input": {
      "model": "nano-banana",
      "prompt": "赛博朋克风格的东京街景",
      "ratio": "16:9",
      "resolution": "2k"
    },
    "result": {
      "type": "image",
      "urls": [
        "https://example.com/output/image1.png",
        "https://example.com/output/image2.png"
      ]
    },
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:55:04.039815Z"
  }
}

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "PROCESSING",
    "input": {
      "model": "nano-banana",
      "prompt": "赛博朋克风格的东京街景"
    },
    "result": null,
    "failure_reason": null,
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:48.000000Z"
  }
}

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad",
    "status": "FAILURE",
    "input": {
      "model": "veo3",
      "prompt": "..."
    },
    "result": null,
    "failure_reason": "INVALID_PARAMETERS",
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:55.000000Z"
  }
}

{
  "code": 404,
  "msg": "task not found"
}

提交任务

取消任务

​响应字段

响应字段