# Imagen 4

> Google's Imagen 4 flagship model.

- **Provider**: replicate
- **Model ID**: google/imagen-4
- **Category**: image_generation
- **Credits**: 93 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

- `aspect_ratio` (string, optional): Aspect ratio of the generated image (Default: `1:1`; Options: `1:1`, `9:16`, `16:9`, `3:4`, `4:3`)
- `safety_filter_level` (string, optional): block_low_and_above is strictest, block_medium_and_above blocks some prompts, block_only_high is most permissive but some prompts will still be blocked (Default: `block_only_high`; Options: `block_low_and_above`, `block_medium_and_above`, `block_only_high`)
- `output_format` (string, optional): Format of the output image (Default: `jpg`; Options: `jpg`, `png`)
- `prompt` (string, **required**): Text prompt for image generation
- `image_size` (string, optional): Resolution of the generated image (Default: `1K`; Options: `1K`, `2K`)

## Example Request

```json
{
  "model": "google/imagen-4",
  "input": {
    "prompt": "The photo: Create a cinematic, photorealistic medium shot capturing the nostalgic warmth of a late 90s indie film. The focus is a young woman with brightly dyed pink-gold hair and freckled skin.",
    "aspect_ratio": "16:9",
    "safety_filter_level": "block_medium_and_above"
  }
}
```

## 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

google, imagen, text-to-image, image-generation, flagship, photorealistic

## Documentation

https://replicate.com/google/imagen-4