Introduction

Mynth is one API in front of many image and video models. You send a model id and a prompt. Mynth routes the request to a provider, retries on another one when it fails, sizes the output for that model, and hands you back a file URL. Switching models is a change to one field.

Every model takes the same request body. There is no per-provider SDK, no per-model options bag, and no field that only one provider understands.

How a generation runs

POST /image/generate  or  POST /video/generate
  │
  ▼
201 { task_id, estimated_cost }     the estimate is held on your balance
  │
  ├─ wait in the SDK, poll the task, or receive a webhook
  ▼
task completed
  result.images[].url              a file URL, kept for 7 days
                                   or your own bucket, if you named a destination

There is no synchronous generate endpoint. mynth.image.generate() in the SDK looks synchronous because it creates the task and polls it for you. Tasks covers statuses, partial failure, and how long files are kept.

Rules worth knowing first

• Pass a model id. Ids are vendor/name, copied from the catalog, for example black-forest-labs/flux.2-pro. There are no aliases. Image generation accepts auto and uses it when model is omitted, but auto is experimental. See the model field.
• Keep the API key on the server. A browser polls one task with the short-lived pat_ token the create call returns. See authentication.
• completed does not mean every image worked. Each item in result.images or result.videos has its own status.
• Mynth is not a file host. Generated files are served for 7 days. Name a destination or copy the file when the task completes.
• Read prices, don't copy them. Prices live in the catalog and in the estimate endpoints. See pricing.
• Mynth does not moderate prompts. A refusal comes from the provider. See prompts and images.

Where to start

• Getting started: a key and a first image, with the SDK, REST or the CLI.
• Authentication: mak_ keys, scopes, spending limits, and the pat_ token.
• Tasks: statuses, partial failure, and the ways to collect a result.
• API reference: every endpoint, generated from the OpenAPI document.

For agents

Every docs page is also plain markdown. Append .md to its URL, or send Accept: text/markdown. This page is /docs.md, the index is /llms.txt, and every page in one file is /llms-full.txt. None of it needs an account.

npx @mynthio/cli docs list
npx @mynthio/cli docs get getting-started

The model catalog is public too: /models.json and GET https://api.mynth.io/models. llms.txt has the details.