Create a batch - Leap

POST

https://api.tryleap.ai

/

v1

/

batches

Create a batch

curl --request POST \
  --url https://api.tryleap.ai/v1/batches \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "requests": [
    {
      "model": "<string>",
      "input": {},
      "webhook": "<string>"
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({requests: [{model: '<string>', input: {}, webhook: '<string>'}]})
};

fetch('https://api.tryleap.ai/v1/batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.tryleap.ai/v1/batches"

payload = { "requests": [
        {
            "model": "<string>",
            "input": {},
            "webhook": "<string>"
        }
    ] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "bat_5Tq8Lm2Xv9Kr4Wn7Bc1Yd3Hp",
  "object": "batch",
  "data": [
    {
      "id": "gen_2Pk7Wd4Qx9Lm1Tn6Vb3Rc8Hy",
      "object": "generation",
      "model": "black-forest-labs/flux-2-pro",
      "modality": "image",
      "status": "queued",
      "provider": null,
      "revision": "2026-10-02",
      "input": {
        "prompt": "A fox in the snow, watercolor",
        "aspect_ratio": "1:1",
        "n": 1
      },
      "output": [],
      "error": null,
      "usage": {
        "cost_usd": null
      },
      "source": "api",
      "batch_id": "bat_5Tq8Lm2Xv9Kr4Wn7Bc1Yd3Hp",
      "created_at": "2026-10-04T18:22:41.512Z",
      "started_at": null,
      "completed_at": null
    },
    {
      "id": "gen_9Rb3Hy6Tc1Vn8Lm4Qx7Wd2Pk",
      "object": "generation",
      "model": "black-forest-labs/flux-2-pro",
      "modality": "image",
      "status": "queued",
      "provider": null,
      "revision": "2026-10-02",
      "input": {
        "prompt": "A fox in the snow, linocut print",
        "aspect_ratio": "1:1",
        "n": 1
      },
      "output": [],
      "error": null,
      "usage": {
        "cost_usd": null
      },
      "source": "api",
      "batch_id": "bat_5Tq8Lm2Xv9Kr4Wn7Bc1Yd3Hp",
      "created_at": "2026-10-04T18:22:41.512Z",
      "started_at": null,
      "completed_at": null
    }
  ]
}

Authorizations

x-api-key

string

header

required

Your workspace API key, leap_.... Create one at https://app.tryleap.ai/go/api, and keep it on your server.

Headers

Idempotency-Key

string

A key you generate for this request, such as a UUID, so a retry never starts a second run. A retry with the same key and body returns the same generation as it is now, marked Idempotent-Replayed: true. The same key with a different body is a 409. A key belongs to your workspace and doesn't expire, so use a new one for each new request.

Required string length: 1 - 255

Pattern: ^[\x21-\x7e]+$

Example:

"7f1c2a9e-3b4d-4e8a-9c21-5d0f6a7b8c90"

Body

application/json

requests

object[]

required

Up to 50 generations, each a model and its input. All are priced and held together.

Required array length: 1 - 50 elements

Show child attributes

Response

The batch, with each generation queued.

Up to 50 generations priced and held together, each run on its own.

id

string

required

The batch's ID, bat_....

object

string

required

Allowed value: "batch"

data

object[]

required

Its generations, in the order you sent them.

Show child attributes

Last modified on October 4, 2026

⌘I

Create a batch

curl --request POST \
  --url https://api.tryleap.ai/v1/batches \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "requests": [
    {
      "model": "<string>",
      "input": {},
      "webhook": "<string>"
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({requests: [{model: '<string>', input: {}, webhook: '<string>'}]})
};

fetch('https://api.tryleap.ai/v1/batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.tryleap.ai/v1/batches"

payload = { "requests": [
        {
            "model": "<string>",
            "input": {},
            "webhook": "<string>"
        }
    ] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "bat_5Tq8Lm2Xv9Kr4Wn7Bc1Yd3Hp",
  "object": "batch",
  "data": [
    {
      "id": "gen_2Pk7Wd4Qx9Lm1Tn6Vb3Rc8Hy",
      "object": "generation",
      "model": "black-forest-labs/flux-2-pro",
      "modality": "image",
      "status": "queued",
      "provider": null,
      "revision": "2026-10-02",
      "input": {
        "prompt": "A fox in the snow, watercolor",
        "aspect_ratio": "1:1",
        "n": 1
      },
      "output": [],
      "error": null,
      "usage": {
        "cost_usd": null
      },
      "source": "api",
      "batch_id": "bat_5Tq8Lm2Xv9Kr4Wn7Bc1Yd3Hp",
      "created_at": "2026-10-04T18:22:41.512Z",
      "started_at": null,
      "completed_at": null
    },
    {
      "id": "gen_9Rb3Hy6Tc1Vn8Lm4Qx7Wd2Pk",
      "object": "generation",
      "model": "black-forest-labs/flux-2-pro",
      "modality": "image",
      "status": "queued",
      "provider": null,
      "revision": "2026-10-02",
      "input": {
        "prompt": "A fox in the snow, linocut print",
        "aspect_ratio": "1:1",
        "n": 1
      },
      "output": [],
      "error": null,
      "usage": {
        "cost_usd": null
      },
      "source": "api",
      "batch_id": "bat_5Tq8Lm2Xv9Kr4Wn7Bc1Yd3Hp",
      "created_at": "2026-10-04T18:22:41.512Z",
      "started_at": null,
      "completed_at": null
    }
  ]
}