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. The same catalog works from ChatGPT, Claude and other AI apps through Leap’s MCP server, with no code, and the Leap skill teaches a coding agent to use the API.

Quickstart

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

Generations

Start a run, then wait for it, long-poll it or get a webhook.

Models and schemas

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

Use it from ChatGPT or Claude

Connect the MCP server and generate from a chat.

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. For video, long-poll GET /v1/generations/{id} with the same header, or name a webhook URL and Leap calls you. 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. 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

MCP server

Examples

Agents

Quickstart

Generations

Models and schemas

Use it from ChatGPT or Claude

How a request works

At a glance

Quickstart

Generations

Models and schemas

Use it from ChatGPT or Claude

​How a request works

​At a glance

How a request works

At a glance