# FLUX.2 Dev - Core.Today AI API

> Development version of FLUX.2 with image editing capabilities and reference image support. Ideal for iterative design workflows and experimentation.

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

## Features
- Image editing capabilities
- Reference image support
- Balanced speed and quality
- Great for iterative workflows
- Cost-effective for development

## Use Cases
- Image editing and modification
- Style transfer using reference images
- Development and testing workflows
- Iterative design prototyping

## 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: []) - Input images for image-to-image generation (max 4)
- **go_fast**: boolean (default: true) - Run faster predictions with additional optimizations
- **aspect_ratio**: string (default: 1:1) - Aspect ratio for the generated image (use 'match_input_image' to match input)
  Options: match_input_image, custom, 1:1, 16:9, 3:2, 2:3, 4:5, 5:4, 9:16, 3:4, 4:3
- **width**: integer - 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).
- **height**: integer - 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).
- **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 of output images (0-100)
- **disable_safety_checker**: boolean (default: false) - Disable safety checker for generated images.

## Examples

### Reference-based Generation
Generate an image guided by a reference
```json
{
  "model": "black-forest-labs/flux-2-dev",
  "input": {
    "prompt": "A cozy reading nook with warm lighting, vintage armchair, floor-to-ceiling bookshelves, photorealistic interior design",
    "image_size": "landscape_4_3",
    "num_inference_steps": 28,
    "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
- Provide a reference image URL to guide the style of generation
- Use guidance_scale to control how closely the output follows your prompt
- Great for testing before upgrading to FLUX 2 Pro
- Combine reference images with detailed prompts for best editing results