API docs / Image models
FLUX 2 Max API
Generates high-fidelity images from text prompts with superior prompt adherence and editing consistency. Supports up to 8 input images for image-to-image generation, enabling consistent editing of characters, objects, styles, and backgrounds across multiple references. Features enhanced creative capabilities for product imagery, cinematic key frames, color variations controlled by hex codes, 3D view generation from single images, and multi-reference editing with state-of-the-art character consistency. Optimized for professional content creation including product marketing, e-commerce, interior design, food imagery, and video production with resolutions up to 4 MP.
- Model id
black-forest-labs/flux-2-max- Provider
- Flux AI
- Output
- Image
- Price
- From 11 credits per run, the same as on voor.ai. Options such as length or resolution can change it.
Request
POST https://voor.ai/v1/generations with "model": "black-forest-labs/flux-2-max". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "black-forest-labs/flux-2-max",
"input": {
"prompt": "A red fox standing in fresh snow at golden hour, soft light"
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Input parameters
| Name | Type | Details |
|---|---|---|
promptrequired | string | Text prompt for image generation |
reference_images | array of URLs | List of input images for image-to-image generation. Maximum 8 images. Must be jpeg, png, gif, or webp. Default: Up to 10 files · Accepts image/* |
aspect_ratio | string | Default: One of: match_input_image, custom, 1:1, 16:9, 3:2, 2:3, 4:5, 5:4, 9:16, 3:4, 4:3 |
resolution | string | Default: One of: match_input_image, 0.5 mp, 1 mp, 2 mp, 4 mp |
seed | number | Random seed. Set for reproducible generation |
output_format | string | Default: One of: webp, jpg, png |
height | number | Height of the generated image. Only used when aspect_ratio=custom. Must be a multiple of 16 (if it's not, it will be rounded to nearest multiple of 16). Min 256 · Max 2048 |
output_quality | number | Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs Default: Min 0 · Max 100 |
width | number | Width of the generated image. Only used when aspect_ratio=custom. Must be a multiple of 16 (if it's not, it will be rounded to nearest multiple of 16). Min 256 · Max 2048 |