# Seedream 4.0

> Unified text-to-image generation and precise single-sentence editing at up to 4K resolution

- **Provider**: replicate
- **Model ID**: bytedance/seedream-4
- **Category**: image_generation
- **Credits**: 59 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

- `image_input` (array, optional): Input image(s) for image-to-image generation. List of 1-10 images for single or multi-reference generation.
- `enhance_prompt` (boolean, optional): Enable prompt enhancement for higher quality results, this will take longer to generate.
- `aspect_ratio` (string, optional): Image aspect ratio. Only used when size is not 'custom'. Use 'match_input_image' to automatically match the input image's aspect ratio.
- `size` (string, optional): Image resolution: 1K (1024px), 2K (2048px), 4K (4096px), or 'custom' for specific dimensions. (Options: `1K`, `2K`, `4K`, `custom`)
- `sequential_image_generation` (string, optional): Group image generation mode. 'disabled' generates a single image. 'auto' lets the model decide whether to generate multiple related images (e.g., story scenes, character variations). (Options: `disabled`, `auto`)
- `width` (integer, optional): Custom image width (only used when size='custom'). Range: 1024-4096 pixels. (Range: min: 1024, max: 4096)
- `max_images` (integer, optional): Maximum number of images to generate when sequential_image_generation='auto'. Range: 1-15. Total images (input + generated) cannot exceed 15. (Range: min: 1, max: 15)
- `prompt` (string, **required**): Text prompt for image generation
- `height` (integer, optional): Custom image height (only used when size='custom'). Range: 1024-4096 pixels. (Range: min: 1024, max: 4096)

## Example Request

```json
{
  "model": "bytedance/seedream-4",
  "input": {
    "image_input": [
      "https://replicate.delivery/pbxt/NgNa2k87ua7v4G2Z51JpiWFcjXoTV1wPVQ86YjmLPfREnWfD/0_1.webp"
    ],
    "aspect_ratio": "4:3",
    "size": "2K",
    "sequential_image_generation": "auto",
    "width": 2048,
    "max_images": 4,
    "prompt": "a selection of photos of this woman looking at a store front and perusing a book shop that's called \"Seedream 4\", it sells books, a poster in the window says \"Seedream 4 now on Replicate\"",
    "height": 2048
  }
}
```

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

json

## Tags

text-to-image, image-to-image, image-editing, high-resolution, 4K, unified-generation, multi-reference, style-transfer, ByteDance

## Documentation

https://replicate.com/bytedance/seedream-4