Quickstart

RESPONSE=$(curl -s 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 silk scarf in the wind on a ferry deck", "aspect_ratio": "3:4" }
  }')

echo "$RESPONSE" | jq .

import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.tryleap.ai/v1/generations", {
  method: "POST",
  headers: {
    "x-api-key": process.env.LEAP_API_KEY ?? "",
    "content-type": "application/json",
    prefer: "wait=60",
  },
  body: JSON.stringify({
    model: "black-forest-labs/flux-2-pro",
    input: { prompt: "A silk scarf in the wind on a ferry deck", aspect_ratio: "3:4" },
  }),
});

const generation = await response.json();
if (!response.ok) throw new Error(generation.error.message);

if (generation.status === "succeeded") {
  const { url } = generation.output[0];
  console.log(url);

  // The link is signed, so downloading it needs no API key.
  const image = await fetch(url);
  if (!image.ok) throw new Error(`Download failed: ${image.status}`);
  await writeFile("scarf.jpg", Buffer.from(await image.arrayBuffer()));
} else if (generation.status === "failed") {
  console.error(generation.error.message);
  process.exitCode = 1;
} else {
  // Still queued or running when the wait ended: poll it until it's done.
  console.log(`${generation.id} is ${generation.status}. Poll GET /v1/generations/${generation.id}.`);
}

import os

import requests

response = requests.post(
    "https://api.tryleap.ai/v1/generations",
    headers={"x-api-key": os.environ["LEAP_API_KEY"], "prefer": "wait=60"},
    json={
        "model": "black-forest-labs/flux-2-pro",
        "input": {"prompt": "A silk scarf in the wind on a ferry deck", "aspect_ratio": "3:4"},
    },
    timeout=90,
)
generation = response.json()
if not response.ok:
    raise RuntimeError(generation["error"]["message"])

if generation["status"] == "succeeded":
    url = generation["output"][0]["url"]
    print(url)

    # The link is signed, so downloading it needs no API key.
    image = requests.get(url, timeout=60)
    image.raise_for_status()
    with open("scarf.jpg", "wb") as f:
        f.write(image.content)
elif generation["status"] == "failed":
    raise SystemExit(generation["error"]["message"])
else:
    # Still queued or running when the wait ended: poll it until it's done.
    print(f"{generation['id']} is {generation['status']}. Poll GET /v1/generations/{generation['id']}.")