Skip to main content
POST
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.
string
required
Model name. For example, nano-banana, veo3, etc. See individual model documentation for details.
object
required
Model input parameters, including prompt and model-specific parameters.
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.
string
Caller’s user identifier, used for request tracing.