# Seedream 5 Pro

> ByteDance's flagship Seedream 5.0 Pro image generation model, with built-in reasoning, precise instruction following, and multi-reference support for up to 10 images. Offers 1K and 2K resolution output with higher fidelity than Seedream 5 Lite.

- **Provider**: replicate
- **Model ID**: bytedance/seedream-5-pro
- **Category**: image_generation
- **Credits**: 210 per request
- **Pricing Type**: input_based

## 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 reference images for single or multi-reference generation. (Default: `[]`)
- `aspect_ratio` (string, optional): Image aspect ratio. Use 'match_input_image' to automatically match the input image's aspect ratio. (Default: `match_input_image`; Options: `match_input_image`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`)
- `size` (string, optional): Image resolution: 1K (~2 megapixels) or 2K (~4 megapixels). (Default: `2K`; Options: `1K`, `2K`)
- `output_format` (string, optional): Output image format. (Default: `png`; Options: `png`, `jpeg`)
- `prompt` (string, **required**): Text prompt for image generation. Maximum 4000 characters. BytePlus recommends keeping prompts under 600 English words for best results.

## Example Request

```json
{
  "model": "bytedance/seedream-5-pro",
  "input": {
    "prompt": "your prompt here"
  }
}
```

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

bytedance, seedream, image-generation, text-to-image, image-editing, multi-reference, reasoning

## Documentation

https://replicate.com/bytedance/seedream-5-pro