Skip to main content

​
Base URL

https://api.maxapi.io

​
Workflow

All AI generation tasks follow the same asynchronous workflow:
1

Submit a Task

Call POST /api/v1/task/submit, specify the model and parameters, and receive a taskId immediately.
2

Wait for Results

Retrieve results by polling GET /api/v1/task/:taskId or by setting up a Webhook callback.
3

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.

​
Common Response Format

Success: 
{
  "code": 0,
  "msg": "ok",
  "data": { ... }
}
Failure: 
{
  "code": 400,
  "msg": "错误描述"
}

​
Task Status

statusDescription
PENDINGQueued, waiting to be processed
PROCESSINGReceived by worker, preparing
SUBMITTEDSubmitted to upstream AI service, waiting for response
SUCCESSTask succeeded, result contains the output
FAILURETask failed
TIMEOUTTask timed out
CANCELLEDTask was cancelled
Status Transitions: 
PENDING → PROCESSING → SUBMITTED → SUCCESS
                                  → FAILURE
                                  → TIMEOUT
          (any non-terminal state) → CANCELLED

​
Supported Models

modelDescription
seedream-5-liteSeedream 5 Lite (Latest)
seedream-4.6Seedream 4.6
seedream-4.5Seedream 4.5
seedream-4Seedream 4