Image generation API
Flux
Black Forest Labs FLUX.1 and FLUX.2 family — open and proprietary image generation models including Pro, Flex, Klein, Kontext, and LoRA variants.
Provider: Black Forest Labs14 models
Available models
| Model key | Display name | Capability | Atlas Cloud slug |
|---|---|---|---|
flux_2_pro_t2i | FLUX.2 Pro T2I | text-to-image | black-forest-labs/flux-2-pro/text-to-image |
flux_2_pro_edit | FLUX.2 Pro Edit | edit | black-forest-labs/flux-2-pro/edit |
flux_2_flex_t2i | FLUX.2 Flex T2I | text-to-image | black-forest-labs/flux-2-flex/text-to-image |
flux_2_flex_edit | FLUX.2 Flex Edit | edit | black-forest-labs/flux-2-flex/edit |
flux_max | FLUX.2 Max | text-to-image | black-forest-labs/flux-2-pro/text-to-image |
flux_pro | FLUX.2 Pro | text-to-image | black-forest-labs/flux-2-pro/text-to-image |
flux_flex | FLUX.2 Flex | text-to-image | black-forest-labs/flux-2-flex/text-to-image |
flux_klein | FLUX.2 Klein | text-to-image | black-forest-labs/flux-schnell |
flux_schnell | FLUX Schnell | text-to-image | black-forest-labs/flux-schnell |
flux_dev | FLUX.1 Dev | text-to-image | black-forest-labs/flux-dev |
flux_kont_max | FLUX Kontext Max | text-to-image | black-forest-labs/flux-kontext-dev |
flux_kont_pro | FLUX Kontext Pro | text-to-image | black-forest-labs/flux-kontext-dev |
flux_dev_lora | FLUX Dev LoRA | text-to-image + lora | black-forest-labs/flux-dev-lora |
flux_kontext_dev_lora | FLUX Kontext Dev LoRA | text-to-image + lora | black-forest-labs/flux-kontext-dev-lora |
Endpoint
POST /api/generateRequest body
| Parameter | Type | Required | Description |
|---|---|---|---|
modelKey | string | ✓ | One of the model keys listed above |
prompt | string | ✓ | Text description of the image to generate |
inputUrl | string | Input image URL (for edit/i2i models) | |
aspectRatio | string | "1:1", "16:9", "9:16", etc. | |
imageQuality | string | "Low", "Medium", "High" | |
styleRef | string | string[] | Style reference image URL(s) | |
charRef | string | string[] | Character reference image URL(s) | |
brandId | string | Brand DNA ID for brand-consistent generation |
Code example
curl -X POST https://api.oyefilmy.com/api/generate \
-H "Authorization: Bearer of_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"modelKey": "flux_2_pro_t2i",
"prompt": "An astronaut riding a horse on Mars, photorealistic, cinematic lighting, 8K resolution"
}'Response
{
"success": true,
"predictionId": "pred_abc123...",
"status": "processing",
"model": "black-forest-labs/flux-2-pro/text-to-image",
"creditCost": 5
}FLUX.2 Pro is best for photorealistic results. Flux Schnell is the fastest option (~2s). Kontext models excel at consistent character generation. LoRA variants allow custom fine-tuning.