Overview
Nano Banana Image
Seedream Image
Grok Imagine (xAI)
GPT Image 2 (OpenAI)
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"
}
}
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"
}
}
Query the current status and generation results of a task byDocumentation Index
Fetch the complete documentation index at: https://docs.maxapi.io/llms.txt
Use this file to discover all available pages before exploring further.
taskId.
The task ID returned when the task was submitted.
Response Fields
Status code.
0 indicates success.Show properties
Show properties
Task ID.
Task status:
PENDING, PROCESSING, SUBMITTED, SUCCESS, FAILURE, TIMEOUT, CANCELLED.The complete input parameters submitted with the task (including model).
Task result. Only has a value when status is
SUCCESS; for other terminal states it is 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 |
Task creation time (ISO 8601).
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"
}
}
⌘I