Skip to main content
POST
POST /v1/images/generations

Request body

string
required
The namespaced model ID, e.g. fal/flux-1.1-pro.
string
required
Image description. Maximum 4000 characters.
integer
default:"1"
Number of images to generate (1–8). Each image bills independently.
string
Desired size. What’s supported depends on the model:
  • OpenAI gpt-image-1: 1024x1024, 1536x1024, 1024x1536
  • OpenAI dall-e-3: 1024x1024, 1792x1024, 1024x1792
  • fal/Recraft/Ideogram: 1024x1024, 1024x768, 768x1024, etc.
string
standard | hd for OpenAI. Other models ignore it.

Response

The URL is ours (Supabase Storage), not the provider’s. It’s persistent and doesn’t expire. Same security model as fal.media, Cloudinary, or unsigned S3: the URL includes 2 UUIDs (org_id + request_id) making it unguessable.

Examples

Expected latency

If your request takes > 60s, assume it failed — send another.

Costs

Each image is billed at the model price × 1.05 (markup) × FX MXN/USD. See Image models. Example: 1 image with Flux 1.1 Pro at FX $20 MXN/USD: