Get Started

Authenticate yourself and submit your first MachGen generation task.

MachGen currently supports programmatic image and video generation via two approaches.

  • REST API Endpoints
  • Client Library (Python)

The core concept is the same: One submits a generation task, polls until it finishes, and downloads the result.

Tasks come in five types:

Task typeWhat it does
T2VText to video
I2VImage to video
R2VReference (subject) to video
T2IText to image
I2IImage editing

See Available Models for which models support each type.

1. Get an API key

Required step

You need an API key regardless of which way you choose - API or client. The API key is associated with rate limiting and billing.

Open Profile -> API Keys, create a key, and copy it. It has the form MGA_<key_id>:<secret> and is shown only once, so store it securely.

Keep it secret

Your key authorizes billable generation against your wallet. Treat it like a password - never commit it or expose it in client-side code.

2. Choose how to call the API

REST API

Call the REST API directly from any language with curl or your HTTP client of choice.

Client Library

Use the official Python client - typed models, automatic uploads, and blocking or streaming waits.

Available Models

Models you can target and the task types each one supports.

On this page

1. Get an API key2. Choose how to call the API