Documentation Index
Fetch the complete documentation index at: https://docs.maxapi.io/llms.txt
Use this file to discover all available pages before exploring further.
Base URL
Workflow
All AI generation tasks follow the same asynchronous workflow:
Submit a Task
Call POST /api/v1/task/submit, specify the model and parameters, and receive a taskId immediately.
Wait for Results
Retrieve results by polling GET /api/v1/task/:taskId or by setting up a Webhook callback.
Get Output
Once the task succeeds, result.urls contains the generated image or video URLs.File URLs are valid for 7 days from the time of generation. Please download and save files promptly to avoid link expiration.
Success:
{
"code": 0,
"msg": "ok",
"data": { ... }
}
Failure:
{
"code": 400,
"msg": "错误描述"
}
Task Status
| status | Description |
|---|
PENDING | Queued, waiting to be processed |
PROCESSING | Received by worker, preparing |
SUBMITTED | Submitted to upstream AI service, waiting for response |
SUCCESS | Task succeeded, result contains the output |
FAILURE | Task failed |
TIMEOUT | Task timed out |
CANCELLED | Task was cancelled |
Status Transitions:
PENDING → PROCESSING → SUBMITTED → SUCCESS
→ FAILURE
→ TIMEOUT
(any non-terminal state) → CANCELLED
Supported Models
Seedream Image
Veo 3 Video
Nano Banana Image
Grok Imagine (xAI)
| model | Description |
|---|
seedream-5-lite | Seedream 5 Lite (Latest) |
seedream-4.5 | Seedream 4.5 |
seedream-4 | Seedream 4 |
| model | Engine | Description |
|---|
veo3 | Veo 3.1 | Quality Mode (Default) — Best generation quality |
veo3_fast | Veo 3.1 | Fast Mode — Speed optimized |
veo3_lite | Veo 3.1 Lite | Lite Mode — 720p only, lowest cost (no R2V, no upscaling) |
| model | Engine | Description |
|---|
nano-banana | Gemini 2.5 Flash | Fast generation (~10-20s) |
nano-banana-2 | Gemini 3.1 Flash | Fast & high quality (~10-20s) |
nano-banana-pro | Gemini 3.0 Pro | High quality (~30-60s) |
| model | Type | Description |
|---|
grok-imagine/text-to-image-lite | image | Text→Image, $0.001/image, n up to 4 |
grok-imagine/text-to-image-standard | image | Text→Image, $0.0012/image, n up to 10 |
grok-imagine/text-to-image-pro | image | Text→Image, $0.0015/image, n up to 10 |
grok-imagine/image-to-image | image | Image edit (1-2 refs, fixed 1024×1024), $0.015/image |
grok-imagine/text-to-video | video | duration 6/10/12/16/20s, $0.007/s |
grok-imagine/image-to-video | video | Up to 5 reference images, $0.007/s |
Common params: ratio (1:1 · 16:9 · 9:16), resolution (images: 720p/1080p · videos: 480p/720p), mode (videos only: fun/normal/spicy/custom).