# FLUX 2 Pro - Core.Today AI API

> Professional-grade FLUX 2 with high-quality editing and up to 8 reference image support. Excellent balance of quality, speed, and creative control.

- **Provider**: Black Forest Labs
- **Model ID**: black-forest-labs/flux-2-pro
- **Category**: Image Generation
- **Credits**: 70 per image
- **Speed**: Medium
- **Quality**: Ultra

## Features
- Up to 8 reference images supported
- High-quality image editing
- Ultra-quality generation
- Professional-grade output
- Excellent prompt understanding

## Use Cases
- Commercial advertising campaigns
- Professional product photography
- High-end image editing
- Brand visual creation
- Print-quality imagery

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text description of the image to generate

### Optional
- **input_images**: array (default: []) - List of input images for image-to-image generation. Maximum 8 images. Must be jpeg, png, gif, or webp.
- **aspect_ratio**: string (default: 1:1) - Aspect ratio for the generated image. Use 'match_input_image' to match the first input image's aspect ratio.
  Options: 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: 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).
  Options: match_input_image, 0.5 MP, 1 MP, 2 MP, 4 MP
- **width**: integer - 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 - 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 (default: 2) - Content safety level (1-6)
- **seed**: integer - Random seed for reproducibility
- **output_format**: string (default: webp) - Format of the output images.
  Options: webp, jpg, png
- **output_quality**: integer (default: 80) - Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs

## Examples

### Premium Product Shot
Generate high-end product photography
```json
{
  "model": "black-forest-labs/flux-2-pro",
  "input": {
    "prompt": "Luxury perfume bottle on polished marble surface, soft diffused lighting, editorial advertisement quality, shallow depth of field, 8k ultra detailed",
    "image_size": "square_hd",
    "guidance_scale": 3.5
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Use reference images to guide the style and composition
- Ideal for commercial projects requiring ultra-quality output
- Adjust guidance_scale for more creative or more faithful results
- Combine with safety_tolerance for content control in production