Query Task - 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": "CONTENT_MODERATION",
    "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": "CONTENT_MODERATION",
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:55.000000Z"
  }
}

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

Query the current status and generation results of a task by taskId.

taskId

string

required

The task ID returned when the task was submitted.

Response Fields

code

integer

Status code. 0 indicates success.

data

object

Show properties

taskId

string

Task ID.

status

string

Task status: PENDING, PROCESSING, SUBMITTED, SUCCESS, FAILURE, TIMEOUT, CANCELLED.

input

object

The complete input parameters submitted with the task (including model).

result

object

Task result. Only has a value when status is SUCCESS; for other terminal states it is null.

Show properties

type

string

Result type: image or video.

urls

string[]

List of URLs for the generated resources. Images may have multiple URLs; videos typically have 1.

URLs expire after 7 days. Please download files promptly.

failure_reason

string | null

Machine-readable failure classification. Always present; null when no specific actionable reason applies.

Value	Meaning	Recommended Action
`CONTENT_MODERATION`	Prompt or image rejected due to real human faces, copyrighted characters or public figures, or NSFW content	Notify the user; do not retry
`INVALID_PARAMETERS`	Submitted parameters are invalid	Fix request parameters; do not retry until corrected
`INSUFFICIENT_POINTS`	Account has insufficient credits	Prompt user to recharge; do not retry
`null`	No specific actionable reason	May retry if appropriate

created_at

string

Task creation time (ISO 8601).

updated_at

string

Task last updated time (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": "CONTENT_MODERATION",
    "created_at": "2026-02-10T21:54:46.686768Z",
    "updated_at": "2026-02-10T21:54:55.000000Z"
  }
}

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

Submit Task

Cancel Task

​Response Fields

Response Fields