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"
  }
}

{
  "code": 400,
  "msg": "model is required"
}

{
  "code": 400,
  "msg": "content rejected by moderation",
  "data": {
    "flagged": true,
    "categories": {
      "harassment": false,
      "harassment/threatening": false,
      "sexual": true,
      "hate": false,
      "hate/threatening": false,
      "illicit": false,
      "illicit/violent": false,
      "self-harm/intent": false,
      "self-harm/instructions": false,
      "self-harm": false,
      "sexual/minors": false,
      "violence": false,
      "violence/graphic": false
    }
  }
}

{
  "code": 401,
  "msg": "unauthorized"
}
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"
  }
}

{
  "code": 400,
  "msg": "model is required"
}

{
  "code": 400,
  "msg": "content rejected by moderation",
  "data": {
    "flagged": true,
    "categories": {
      "harassment": false,
      "harassment/threatening": false,
      "sexual": true,
      "hate": false,
      "hate/threatening": false,
      "illicit": false,
      "illicit/violent": false,
      "self-harm/intent": false,
      "self-harm/instructions": false,
      "self-harm": false,
      "sexual/minors": false,
      "violence": false,
      "violence/graphic": false
    }
  }
}

{
  "code": 401,
  "msg": "unauthorized"
}