List available image and video models with their capability constraints. Read this before generating: supported resolutions, durations, aspect ratios and reference-image slots differ per model.

Generate one image synchronously and return the finished asset with both its local filesystem path and its HTTP URL. Blocks until the image exists. Batch generation is not supported.

Submit a video generation job and return its ID immediately. Does NOT wait for the render; poll with get_job.

Fetch a generation's current state, optionally long-polling for up to wait_seconds. Returns the finished asset once the state is COMPLETE.

Ingest a local file into a project's uploads directory and return an asset ID usable as an image reference or a video frame.

Browse the library with optional project, kind, model and date filters.

Full metadata for one generation, including its input lineage.

Delete a generation together with its files and thumbnails.

List projects. 'unsorted' always exists.

Create a project and return its slug.

Provider-authoritative remaining credit plus local daily-cap status. Amounts are strings or null; null means the cost is unknown, never zero.