FLUX.2 [Pro]
Creative Studio image model reference for the public API.
FLUX.2 [Pro]
Public model ID: flux2-pro
Asset type: image
Category: Generation
Starting credits: 0.1 (defaults: 0.15)
Prompt required.
Start a generation
curl -s -X POST "$API_BASE_URL/v1/creative-studio/generations" \
-H "Authorization: Bearer vsl_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"modelId": "flux2-pro",
"prompt": "Your prompt here",
"input_images": ["https://example.com/reference.jpg"],
"aspect_ratio": "1:1"
}' | jqPoll GET /v1/creative-studio/generations/{id} until status is completed. Completed generations return outputUrl on cdn.videoslash.com.
Media parameters
| Name | Type | Constraints | Default | Description |
|---|---|---|---|---|
input_images | array | optional · max items: 8 | [] | List of input images for image-to-image generation. Maximum 8 images. Must be jpeg, png, gif, or webp. |
Settings parameters
| Name | Type | Constraints | Default | Description |
|---|---|---|---|---|
aspect_ratio | enum | optional · enum: match_input_image, custom, 1:1, 16:9, 3:2, 2:3, 4:5, 5:4, 9:16, 3:4, 4:3 | 1:1 | Aspect ratio for the generated image. Use 'match_input_image' to match the first input image's aspect ratio. |
resolution | enum | optional · enum: match_input_image, 0.5 MP, 1 MP, 2 MP, 4 MP | 1 MP | Resolution in megapixels. Up to 4 MP is possible, but 2 MP or below is recommended. The maximum image size is 2048x2048, which means that high-resolution images may not respect the resolution if aspect ratio is not 1:1. |
Resolution is not used when aspect_ratio is 'custom'. When aspect_ratio is 'match_input_image', use 'match_input_image' to match the input image's resolution (clamped to 0.5-4 MP). |
| width | integer | optional · min: 256 · max: 2048 | — | 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). |
| height | integer | optional · min: 256 · max: 2048 | — | 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). |
| safety_tolerance | integer | optional · min: 1 · max: 5 | 2 | Safety tolerance, 1 is most strict and 5 is most permissive |
| seed | integer | optional | — | Random seed. Set for reproducible generation |
| output_format | enum | optional · enum: webp, jpg, png | webp | Format of the output images. |
| output_quality | integer | optional · min: 0 · max: 100 | 80 | Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs |