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"
}
Task API
Query Task
Query task status and results
GET
/
api
/
v1
/
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.
string
required
The task ID returned when the task was submitted.
Response Fields
integer
Status code.
0 indicates success.object
Show properties
Show properties
string
Task ID.
string
Task status:
PENDING, PROCESSING, SUBMITTED, SUCCESS, FAILURE, TIMEOUT, CANCELLED.object
The complete input parameters submitted with the task (including model).
object
Task result. Only has a value when status is
SUCCESS; for other terminal states it is null.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 |
string
Task creation time (ISO 8601).
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"
}
⌘I