# FLUX.2 Dev

> Quality image generation and editing with support for reference images

- **Provider**: replicate
- **Model ID**: black-forest-labs/flux-2-dev
- **Category**: image_generation
- **Credits**: 25 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `input_images` (array, optional): List of input images for image-to-image generation. Must be jpeg, png, gif, or webp
- `aspect_ratio` (string, optional): Aspect ratio for the generated image. Use 'match_input_image' to match the first input image's aspect ratio
- `disable_safety_checker` (boolean, optional): Disable safety checker for generated images
- `seed` (integer, optional): Random seed. Set for reproducible generation
- `output_format` (string, optional): Format of the output images
- `go_fast` (boolean, optional): Run faster predictions with additional optimizations
- `width` (integer, optional): Width of the generated image in text-to-image mode. Only used when aspect_ratio=custom. Must be a multiple of 32 (if it's not, it will be rounded to nearest multiple of 32)
- `prompt` (string, **required**): Text description of the image to generate
- `output_quality` (integer, optional): Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs (Range: min: 0, max: 100)
- `height` (integer, optional): Height of the generated image in text-to-image mode. Only used when aspect_ratio=custom. Must be a multiple of 32 (if it's not, it will be rounded to nearest multiple of 32)

## Example Request

```json
{
  "model": "black-forest-labs/flux-2-dev",
  "input": {
    "aspect_ratio": "match_input_image",
    "input_images": [
      "https://replicate.delivery/pbxt/O7kbtH7wgLIItlCyeWjm0fgPpx7OpGsT9VbYyxBXnfieVxQe/woman-by-car.jpg"
    ],
    "output_format": "jpg",
    "prompt": "Replace the color of the car to blue",
    "go_fast": true,
    "output_quality": 80
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

image-generation, image-editing, flux, black-forest-labs, text-to-image, photorealistic

## Documentation

https://docs.bfl.ai/flux_2/