> ## Documentation Index > Fetch the complete documentation index at: https://www.tryleap.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Leap's API is at https://api.tryleap.ai. Send the key in the x-api-key header or as Authorization: Bearer; keys start with leap_. > Take model IDs and input schemas from GET /v1/models/{creator}/{name}, or from https://api.tryleap.ai/v1/public/models without a key. Never guess an input field: unknown fields are a 400. > Model inputs take uploaded file IDs (file_...), never URLs. > To give a coding agent the whole API, install the Leap skill: curl -fsSL https://www.tryleap.ai/install.sh | sh > The full OpenAPI 3.1 spec is at https://www.tryleap.ai/docs/openapi.json. # Create a generation > Starts a run of any model or preset. Every model takes this same shape; only `input` differs, as the model's `input_schema` says. The price is held from your balance first, and charged only if the run succeeds. Without `Prefer`, the answer comes at once with the generation `queued`. With `Prefer: wait=60`, it comes when the run finishes or after 60 seconds, whichever is first: most images finish inside the wait, and video doesn't. Send an `Idempotency-Key` so a retry never starts a second run. Needs an API key with the `generations:write` scope. ## OpenAPI ````yaml /openapi.json post /v1/generations openapi: 3.1.0 info: title: Leap API version: 1.0.0 description: >- One API for the best image, video and audio models. Every request goes to `https://api.tryleap.ai` with your API key in the `x-api-key` header, or as `Authorization: Bearer leap_...`. Create a key at https://app.tryleap.ai/go/api. Guides, examples and the errors list are at https://www.tryleap.ai/docs. servers: - url: https://api.tryleap.ai security: - ApiKey: [] - Bearer: [] tags: - name: Models description: >- Every model and preset you can run, with its price and the JSON Schema of the input it takes. - name: Quotes description: >- The exact price of a run before you start it, with its input checked and its defaults filled in. - name: Generations description: >- A generation is one run of a model or preset: queued, then running, then succeeded, failed or canceled. Only a succeeded run is charged. - name: Batches description: >- Up to 50 generations priced and held together in one request, each then run as its own generation. - name: Webhooks description: >- URLs your workspace's events are POSTed to, signed following Standard Webhooks, and the default secret for the `webhook` URL a request names. - name: Events description: >- What happened in your workspace, kept 30 days, with each delivery to your webhooks and a way to send one again. - name: Files description: >- Photos, videos and sounds that models take as input. Upload one, then pass its `file_...` ID in the input field the model's schema names. - name: Credits description: Your workspace's balance in US dollars. externalDocs: url: https://www.tryleap.ai/docs paths: /v1/generations: post: tags: - Generations summary: Create a generation description: >- Starts a run of any model or preset. Every model takes this same shape; only `input` differs, as the model's `input_schema` says. The price is held from your balance first, and charged only if the run succeeds. Without `Prefer`, the answer comes at once with the generation `queued`. With `Prefer: wait=60`, it comes when the run finishes or after 60 seconds, whichever is first: most images finish inside the wait, and video doesn't. Send an `Idempotency-Key` so a retry never starts a second run. Needs an API key with the `generations:write` scope. operationId: createGeneration parameters: - in: header name: Idempotency-Key schema: description: >- 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. example: 7f1c2a9e-3b4d-4e8a-9c21-5d0f6a7b8c90 type: string minLength: 1 maxLength: 255 pattern: ^[\x21-\x7e]+$ description: >- 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. - in: header name: Prefer schema: description: >- `wait=N` holds the request open for up to N seconds (at most 60) until the generation finishes, and `Preference-Applied` echoes the wait used. Most images finish inside the wait. If the run is still going when it ends, you get it back `queued` or `running`; poll it from there. Without this header the generation comes back queued at once. example: wait=60 type: string description: >- `wait=N` holds the request open for up to N seconds (at most 60) until the generation finishes, and `Preference-Applied` echoes the wait used. Most images finish inside the wait. If the run is still going when it ends, you get it back `queued` or `running`; poll it from there. Without this header the generation comes back queued at once. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GenerationRequest' responses: '201': description: 'The generation: `queued` at once, or as it is when the wait ends.' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' Location: schema: type: string description: The new resource's path, such as `/v1/generations/gen_...`. Idempotent-Replayed: schema: type: string const: 'true' description: >- Present when this answer replays the first request sent with the same `Idempotency-Key`. Preference-Applied: schema: type: string description: The wait that was applied, such as `wait=60`. Retry-After: schema: type: integer minimum: 0 maximum: 9007199254740991 description: >- While a run is still `queued` or `running`: seconds to wait before you read it again, 2 for images and audio, 5 for video and 3D. A final answer has none. example: 5 Deprecation: schema: type: string description: >- Present when the model or preset is deprecated: when it was, as `@` and a Unix time (RFC 9745). Sunset: schema: type: string description: >- Present when the model or preset is deprecated: the date it stops running, as an HTTP date (RFC 8594). Link: schema: type: string description: >- For a deprecated model with a replacement: `; rel="successor-version"`. content: application/json: example: id: gen_7Hq2mVx9Lr4Kp8Tn3Wc6Yb1D object: generation model: google/veo-3.1-fast modality: video status: queued provider: null revision: '2026-10-02' input: prompt: A heron lands on a still lake at dawn aspect_ratio: '16:9' 'n': 1 duration: 4 resolution: 1080p audio: true output: [] error: null usage: cost_usd: null source: api batch_id: null created_at: '2026-10-04T18:22:41.512Z' started_at: null completed_at: null schema: $ref: '#/components/schemas/Generation' '400': $ref: '#/components/responses/InvalidParameterOrConflictingCredentials' '401': $ref: '#/components/responses/AuthenticationRequired' '402': $ref: '#/components/responses/InsufficientCredit' '403': $ref: '#/components/responses/PermissionDenied' '409': $ref: '#/components/responses/Conflict' '410': $ref: '#/components/responses/Gone' '429': $ref: '#/components/responses/RateLimitExceeded' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: GenerationRequest: type: object properties: model: type: string maxLength: 100 pattern: ^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9.-]*(@[1-9][0-9]{0,3})?$ description: >- The model or preset to run, such as `black-forest-labs/flux-2-pro` or `leap/restore-photo@1`. A preset ID without `@N` runs its latest version. input: default: {} description: >- The model's input, as its `input_schema` from `GET /v1/models/{creator}/{name}` describes it. Fields you leave out take their defaults; unknown fields are refused. Files are `file_...` IDs. type: object propertyNames: type: string additionalProperties: {} webhook: description: >- An https URL to POST the generation.succeeded, generation.failed or generation.canceled event to when the run ends, signed with your workspace's default secret (GET /v1/webhooks/default/secret). type: string maxLength: 2048 format: uri required: - model additionalProperties: false Generation: type: object properties: id: type: string description: The generation's ID, `gen_` and 24 letters and digits. object: type: string const: generation model: type: string description: The model or preset it runs, with a preset's version. modality: type: string enum: - image - video - audio - 3d - text description: 'What it makes: `image`, `video`, `audio`, `3d` or `text`.' status: type: string enum: - queued - running - succeeded - failed - canceled description: >- `queued`, then `running`, then one of `succeeded`, `failed` or `canceled`. Only `succeeded` is charged. provider: description: >- Which upstream ran it, once one did. Informational: the model ID and input stay the same whichever runs it. type: - string - 'null' revision: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: The model's schema and price revision the run used. input: type: object propertyNames: type: string additionalProperties: anyOf: - type: - string - number - boolean - type: object propertyNames: type: string additionalProperties: type: - string - number - boolean - type: array items: type: string description: The input as it runs, with the defaults filled in. output: type: array items: type: object properties: type: type: string enum: - image - video - audio - 3d - text description: 'What the file is: `image`, `video`, `audio`, `3d` or `text`.' url: type: string format: uri description: >- A signed link to the file. Download what you keep: links expire after 24 hours, and reading the generation again signs fresh ones. expires_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ description: When `url` stops working, 24 hours after it was signed. content_type: type: string description: The file's media type, such as `image/jpeg` or `video/mp4`. width: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' description: Width in pixels; null for a sound. height: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' description: Height in pixels; null for a sound. poster: description: >- For a video: a JPEG of a frame from its middle, about 720 pixels on the long side. Absent when none was made. type: object properties: url: type: string format: uri description: >- A signed link to the poster, which expires with the video's link. expires_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ width: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 height: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - url - expires_at - width - height additionalProperties: false required: - type - url - expires_at - content_type - width - height additionalProperties: false preview: description: >- While a preset that makes a still first is running: that still, once it exists, before the video it becomes. Absent for every other run, and for a run whose video also reads words or a photo you sent, such as a line to say or a photo the clip starts from: that still comes with the video. type: object properties: url: type: string format: uri description: >- A signed link to the still, which expires after 24 hours like an output's. expires_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ width: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' height: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' required: - url - expires_at - width - height additionalProperties: false error: anyOf: - type: object properties: message: type: string required: - message additionalProperties: false - type: 'null' description: >- Why a `failed` run failed, such as a refused prompt or a provider error; null otherwise. A failed run isn't charged. usage: type: object properties: cost_usd: description: >- What the run cost, as an exact decimal string in US dollars; null until it's charged. type: - string - 'null' required: - cost_usd additionalProperties: false description: What the run cost your workspace. source: anyOf: - type: string enum: - studio - api - mcp - type: 'null' description: 'Where it was started: `api`, `mcp` or `studio`.' batch_id: description: The batch it belongs to, `bat_...`; null if none. type: - string - 'null' created_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ description: When it was created. started_at: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ - type: 'null' description: When it started running; null while queued. completed_at: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ - type: 'null' description: When it reached a final status; null before. required: - id - object - model - modality - status - provider - revision - input - output - error - usage - source - batch_id - created_at - started_at - completed_at additionalProperties: false description: >- One run of a model or preset, with its status, its outputs and what it cost. Error: type: object properties: error: type: object properties: type: type: string enum: - invalid_request_error - rate_limit_error - authentication_error - permission_error - conflict_error - billing_error - api_error description: >- The kind of error. Branch on `type` and `code`, never on `message`. code: type: string enum: - invalid_parameter - invalid_request - conflicting_credentials - placeholder_in_path - method_not_allowed - payload_too_large - unsupported_media_type - ip_rate_limit_exceeded - authentication_required - missing_api_key - invalid_api_key - permission_denied - not_found - resource_not_found - gone - conflict - rate_limit_exceeded - insufficient_credit - service_unavailable - internal_error description: >- A stable code for this error. Each one is explained at https://www.tryleap.ai/docs/errors. message: type: string description: >- What went wrong, written for a person. It can change; don't parse it. param: description: >- For a `400`, the field at fault, such as `input.prompt`; otherwise null. type: - string - 'null' doc_url: description: A page that explains this error, when there is one. type: - string - 'null' request_id: type: string description: >- This request's ID, as in the `X-Request-Id` header. Include it when you contact support. required: - type - code - message - param - doc_url - request_id additionalProperties: false required: - error additionalProperties: false headers: X-Request-Id: required: true description: >- This request's ID. Include it when you contact support; it's also `request_id` in an error. schema: type: string description: >- This request's ID. Include it when you contact support; it's also `request_id` in an error. example: req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2 RateLimit-Limit: required: true description: Requests allowed per window from your client. schema: type: integer minimum: 0 maximum: 9007199254740991 description: Requests allowed per window from your client. example: 300 RateLimit-Remaining: required: true description: Requests left in the current window. schema: type: integer minimum: 0 maximum: 9007199254740991 description: Requests left in the current window. example: 299 RateLimit-Reset: required: true description: Seconds until the window resets. schema: type: integer minimum: 0 maximum: 9007199254740991 description: Seconds until the window resets. example: 42 Retry-After: required: true description: Seconds to wait before you retry. schema: type: integer minimum: 0 maximum: 9007199254740991 description: Seconds to wait before you retry. example: 42 responses: InvalidParameterOrConflictingCredentials: description: '`invalid_parameter`, `conflicting_credentials`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_parameter: value: error: type: invalid_request_error code: invalid_parameter message: Invalid request parameters. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD conflicting_credentials: value: error: type: invalid_request_error code: conflicting_credentials message: Send one API key. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD AuthenticationRequired: description: '`authentication_required`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' examples: authentication_required: value: error: type: authentication_error code: authentication_required message: Authentication is required. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD InsufficientCredit: description: '`insufficient_credit`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' examples: insufficient_credit: value: error: type: billing_error code: insufficient_credit message: Not enough credit. Add credits to keep generating. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD PermissionDenied: description: '`permission_denied`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' examples: permission_denied: value: error: type: permission_error code: permission_denied message: Permission denied. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD Conflict: description: '`conflict`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' examples: conflict: value: error: type: conflict_error code: conflict message: The request conflicts with the current state. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD Gone: description: '`gone`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' examples: gone: value: error: type: invalid_request_error code: gone message: That resource was retired. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD RateLimitExceeded: description: '`rate_limit_exceeded`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limit_exceeded: value: error: type: rate_limit_error code: rate_limit_exceeded message: Too Many Requests param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD ServiceUnavailable: description: '`service_unavailable`' headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/Error' examples: service_unavailable: value: error: type: api_error code: service_unavailable message: Service unavailable. param: null doc_url: null request_id: req_8kQ2vX9mR4tL6nB1cW3yZ5aD securitySchemes: ApiKey: type: apiKey in: header name: x-api-key description: >- Your workspace API key, `leap_...`. Create one at https://app.tryleap.ai/go/api, and keep it on your server. Bearer: type: http scheme: bearer description: >- The same API key as `Authorization: Bearer leap_...`, the way most HTTP clients and coding agents send one. Send one header or the other; two different keys are a `400`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.