# FLUX.1 Schnell - Core.Today AI API

> Ultra-fast image generation model optimized for speed. Generates high-quality images in just 1-2 seconds, perfect for real-time applications and rapid prototyping.

- **Provider**: Black Forest Labs
- **Model ID**: black-forest-labs/flux-schnell
- **Category**: Image Generation
- **Credits**: 7 per image
- **Speed**: Fast
- **Quality**: High

## Features
- Ultra-fast generation (1-2 seconds)
- High-quality output at 1024x1024
- Excellent prompt understanding
- Great for real-time applications
- Low credit cost per generation

## Use Cases
- Rapid prototyping and ideation
- Real-time image generation in apps
- Social media content creation
- Quick concept visualization
- A/B testing different prompts

## 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
- **aspect_ratio**: string (default: 1:1) - Aspect ratio for the generated image
  Options: 1:1, 16:9, 21:9, 3:2, 2:3, 4:5, 5:4, 3:4, 4:3, 9:16, 9:21
- **num_outputs**: integer (default: 1) - Number of outputs to generate
- **num_inference_steps**: integer (default: 4) - Number of denoising steps (recommended: 4)
- **seed**: integer - Random seed for reproducibility
- **output_format**: string (default: webp) - Format of 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.
- **go_fast**: boolean (default: true) - Run faster with fp8 quantized model
- **megapixels**: string (default: 1) - Approximate megapixels for output
  Options: 1, 0.25

## Examples

### Product Photography
Generate professional product shots
```json
{
  "model": "black-forest-labs/flux-schnell",
  "input": {
    "prompt": "A sleek wireless headphone on a minimalist white marble surface, professional product photography, soft studio lighting, 8k ultra detailed",
    "image_size": "landscape_4_3",
    "num_inference_steps": 4
  }
}
```

### Character Design
Create unique character concepts
```json
{
  "model": "black-forest-labs/flux-schnell",
  "input": {
    "prompt": "A cyberpunk samurai warrior with glowing neon armor, detailed character design, concept art style, dramatic lighting",
    "image_size": "portrait_4_3"
  }
}
```

### Landscape Art
Generate stunning landscapes
```json
{
  "model": "black-forest-labs/flux-schnell",
  "input": {
    "prompt": "Breathtaking mountain vista at golden hour, misty valleys below, photorealistic landscape photography, National Geographic style",
    "image_size": "landscape_16_9"
  }
}
```

## 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 specific, detailed prompts for better results
- Include style references like 'professional photography' or 'concept art'
- Specify lighting conditions for more control
- Use seed values to reproduce similar results
- Start with 4 inference steps, increase only if needed

## Documentation
https://fal.ai/models/fal-ai/flux/schnell