API docs / Image models
FLUX 2 Pro API
Generates high-quality images from text prompts with support for image-to-image generation using up to eight reference images. Supports various aspect ratios including 1:1, 16:9, 3:2, 2:3, 4:5, 5:4, 9:16, 3:4, and 4:3, with resolutions up to 4 megapixels and maximum dimensions of 2048x2048. Includes custom width and height settings, configurable safety tolerance, and multiple output formats including webp, jpg, and png.
- Model id
black-forest-labs/flux-2-pro- Provider
- Flux AI
- Output
- Image
- Price
- From 354 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-pro". 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-pro",
"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 |