Skip to main content
You can integrate Lumenfall with any programming language or tool that supports HTTP requests. This guide shows how to use the API directly without an SDK.

Base URL

All API requests should be made to:

Authentication

Include your API key in the Authorization header:

Generate images

Make a POST request to /images/generations:

Response

Request parameters

Get base64 response

Passing additional parameters

Include any additional parameters in the JSON request body:
Additional parameters are passed directly to the upstream provider. Check the provider’s documentation for supported parameters.

Edit images

Make a POST request to /images/edits with multipart form data:

With a mask

Provide a mask to specify which areas should be edited:

List models

Get all available models:
Response:

Get a specific model

Estimate costs (dry run)

Add ?dryRun=true to get a cost estimate without generating:
Response:

Response headers

Lumenfall includes useful headers in every response:

Error handling

Error response format

HTTP status codes

Next steps

API Reference

Explore the full API documentation.

Authentication

Learn more about API key management.