Skip to main content
POST
/
api
/
v1
/
task
/
submit
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana",
  "input": {
    "prompt": "A cyberpunk Tokyo street"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad"
  }
}

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.

Submit an asynchronous generation task. All models (image, video) share this endpoint, distinguished by the model parameter.
400 responses from this endpoint can mean either:
  • request validation failed, such as a missing required field
  • the request was blocked by pre-submission content moderation
If the request is rejected by content moderation, the response includes msg: "content rejected by moderation" plus data.flagged and data.categories fields with the moderation result details.
​
model
string
required
Model name. For example, nano-banana, veo3, etc. See individual model documentation for details.
​
input
object
required
Model input parameters, including prompt and model-specific parameters.
​
callBackUrl
string
Webhook callback URL. When the task reaches a terminal state, the system will send a POST request to this URL. Localhost is not supported.
​
user_id
string
Caller’s user identifier, used for request tracing.
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana",
  "input": {
    "prompt": "A cyberpunk Tokyo street"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "9db7d1ed-d1e5-4d11-9f3a-61f653b905ad"
  }
}