Leap API

Leap runs the best image, video and audio models behind one request shape. Pick a model, send its input, get back a file. You pay from one balance, you can price any run before you start it, and a run that fails is never charged. Besides raw models, the catalog has presets: ready-made recipes such as leap/restore-photo@1 or leap/headshot@1 that pair a model with an expert prompt. You call a preset exactly like a model.

Quickstart

Create a key and get your first image in one request.

Generations

Start a run, then wait for it, poll it or cancel it.

Models and schemas

Find a model and read the JSON Schema of its input.

Use it from your agent

Install the Leap skill, or connect over MCP.

How a request works

Find a model. GET /v1/models lists every model and preset with its price. GET /v1/models/{creator}/{name} returns one with its input_schema, the JSON Schema of the input it takes.
Start a run: send POST /v1/generations with {"model": "...", "input": {...}}.
Get the result. Add prefer: wait=60 to get an image back in the same request, or poll GET /v1/generations/{id} until the status is final. Each output is a signed link to the file.

curl https://api.tryleap.ai/v1/generations \
  -H "x-api-key: $LEAP_API_KEY" \
  -H "content-type: application/json" \
  -H "prefer: wait=60" \
  -d '{"model": "black-forest-labs/flux-2-pro", "input": {"prompt": "A red bicycle against a yellow wall"}}'

At a glance


Base URL	`https://api.tryleap.ai`
Authentication	Your key in the `x-api-key` header, or as `Authorization: Bearer`. See Authentication.
Format	JSON in and out, with `snake_case` fields. The exception is `lengthOf` and `lengthStep` in a price. An image upload takes the raw file as its body.
IDs	A prefix and 24 letters and digits: `gen_` for a generation, `file_` for a file, `bat_` for a batch.
Money	US dollars as exact decimal strings, such as `"0.033"`. See Pricing and credits.
Times	ISO 8601 in UTC, such as `2026-10-04T18:22:41.512Z`.
Lists	Paginated lists, such as `GET /v1/generations`, come newest first, 50 rows a page by default, with `next_cursor` for the next page. The model catalog comes whole, without pages.
Output links	Signed and valid for 24 hours. Reading the generation again signs fresh ones.
Errors	One JSON shape with a stable `type` and `code`. See Errors and retries.
Reference	Every endpoint, with its parameters, responses and errors, in the API reference. It’s built from the API’s own code, and the raw OpenAPI 3.1 file is at /docs/openapi.json.

Get started

Build

Examples

Agents

Quickstart

Generations

Models and schemas

Use it from your agent

How a request works

At a glance

Quickstart

Generations

Models and schemas

Use it from your agent

​How a request works

​At a glance

How a request works

At a glance