Skip to main content
MiniMax tasks are asynchronous. Save the public id returned by the create request and poll the retrieve endpoint with an authorized GENGEN API key.

Track completion

Continue polling while the task is pending or processing. When it is succeeded, read video URLs from outputs.videos. If it is failed or cancelled, stop polling and inspect the returned failure details before deciding whether to submit a new task. Copy successful videos to your own storage for durable access. Customer webhook subscriptions are not available for these endpoints. Use polling to track completion; processing continues when your client disconnects.

Handle request errors

Request failures use the GENGEN error envelope. Branch on HTTP status and error_code; optional diagnostic codes and request identifiers help support locate an issue. Do not depend on the exact message text.
  • Correct invalid parameters, conflicting media inputs, or rejected content before resubmitting.
  • Reduce concurrency after rate-limit errors and use exponential backoff for polling.
  • Check your GENGEN wallet when the error reports insufficient wallet balance.
  • Contact GENGEN support for model access or service errors, including the task ID and returned diagnostics.
A timeout during creation does not confirm failure. Poll an existing task ID if you have one; avoid automatically repeating a create request whose outcome is unknown, because it can create a second billable task.