# Seedream 5.0 Pro

> Seedream 5.0 Pro, an image generation model by ByteDance.

- **Model ID**: `bytedance/seedream-5.0-pro`
- **Maker**: ByteDance
- **Type**: image
- **Status**: live
- **Timeout**: 600 s
- **Unified format**: Supported
- **Endpoint**: `POST https://api.kerox.ai/v1/tasks`
- **Model page**: https://kerox.ai/models/bytedance/seedream-5.0-pro

## Pricing

| Tier | Official / image | Kerox / image | Savings |
| --- | --- | --- | --- |
| 1K/1.5K | $0.0450 | $0.0360 | 20% |
| 2K | $0.0900 | $0.0720 | 20% |

- **Tiers**: set by the pixel count (width × height) of each output image: up to 2,610,000 px is `1K/1.5K`; anything larger is `2K`.
- **Reference images**: the first 1 is free; each one after that adds $0.0024 (official $0.0030).

## Request example

Submit a task with the model's native parameters.

### cURL

```bash
curl -X POST https://api.kerox.ai/v1/tasks \
  -H "Authorization: Bearer $KEROX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro",
  "input": {
    "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
    "size": "2K"
  },
  "wait_seconds": 30
}'
```

### Python

```python
import os
import requests

resp = requests.post(
    "https://api.kerox.ai/v1/tasks",
    headers={
        "Authorization": f"Bearer {os.environ['KEROX_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "bytedance/seedream-5.0-pro",
        "input": {
            "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
            "size": "2K",
        },
        "wait_seconds": 30,
    },
    timeout=60,
)
resp.raise_for_status()
task = resp.json()
print(task["id"], task["status"], task["output"])
```

### Node.js

```javascript
const res = await fetch('https://api.kerox.ai/v1/tasks', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.KEROX_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "model": "bytedance/seedream-5.0-pro",
    "input": {
      "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
      "size": "2K"
    },
    "wait_seconds": 30
  }),
});
const task = await res.json();
console.log(task.id, task.status, task.output);
```

### Go

```go
package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
  "model": "bytedance/seedream-5.0-pro",
  "input": {
    "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
    "size": "2K"
  },
  "wait_seconds": 30
}`)
	req, _ := http.NewRequest("POST", "https://api.kerox.ai/v1/tasks", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("KEROX_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}
```

## Parameters (native format)

| Parameter | Type | Default | Values | Description |
| --- | --- | --- | --- | --- |
| `size` | string | `"2K"` | — | Size |
| `image` | string \| string[] | — | — | Reference images |
| `prompt` | string | — | — | Prompt |
| `watermark` | boolean | `false` | — | Watermark |
| `background` | string | `"opaque"` | transparent, opaque | Background |
| `output_format` | string | `"jpeg"` | jpeg, png | Output format |
| `safety_identifier` | string | — | — | End-user ID |
| `optimize_prompt_options` | object | `{"mode":"standard"}` | — | Prompt optimization |

## Parameters (unified format, `format: "unified"`)

| Parameter | Type | Default | Values | Description |
| --- | --- | --- | --- | --- |
| `n` | integer | `1` | 1 | Number of outputs |
| `images` | string \| string[] | — | — | Reference images |
| `prompt` | string | — | — | Prompt |
| `resolution` | string | `"2K"` | 1K, 1.5K, 2K | Resolution |
| `aspect_ratio` | string | `"auto"` | auto, 1:1, 1:2, 1:3, 2:1, 2:3, 3:1, 3:2, 3:4, 4:3, 4:5, 5:4, 16:9, 21:9, 9:16, 9:21 | Aspect ratio |
| `watermark` | boolean | `false` | — | Watermark |
| `background` | string | `"opaque"` | transparent, opaque | Background |
| `output_format` | string | `"jpeg"` | jpeg, png | Output format |
| `safety_identifier` | string | — | — | End-user ID |
| `optimize_prompt_options` | object | `{"mode":"standard"}` | — | Prompt optimization |

## Polling and output

Poll `GET /v1/tasks/{id}` or receive a webhook when the task finishes. Output files expire at `expires_at` (7 days after completion), so download anything you want to keep. The other fields of the task object are in the tasks guide and the API reference.

```bash
curl https://api.kerox.ai/v1/tasks/task_01JD8X9B4Q2M7T8N3K5P6R1S0V \
  -H "Authorization: Bearer $KEROX_API_KEY"
```

```json
{
  "id": "task_01JD8X9B4Q2M7T8N3K5P6R1S0V",
  "object": "task",
  "model": "bytedance/seedream-5.0-pro",
  "status": "succeeded",
  "output": {
    "images": [
      {
        "url": "https://cdn.kerox.ai/t/task_01JD8X9B4Q2M7T8N3K5P6R1S0V/5f2b8c1e9d3a4f6b8a7c0d1e2f3a4b5c/0.png",
        "content_type": "image/png",
        "width": 2048,
        "height": 2048
      }
    ]
  },
  "error": null,
  "expires_at": "2026-11-27T08:01:10Z"
}
```

## Input schema (JSON)

```json
{
  "type": "object",
  "allOf": [
    {
      "if": {
        "required": [
          "background"
        ],
        "properties": {
          "background": {
            "const": "transparent"
          }
        }
      },
      "then": {
        "required": [
          "image"
        ],
        "properties": {
          "image": {
            "oneOf": [
              {
                "type": "string",
                "pattern": "^(https://|data:image/)"
              },
              {
                "type": "array",
                "maxItems": 1
              }
            ]
          },
          "output_format": {
            "const": "png"
          }
        }
      }
    }
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt"
  ],
  "properties": {
    "size": {
      "type": "string",
      "x-tier": "common",
      "default": "2K",
      "pattern": "^(1K|1\\.5K|2K|[1-9][0-9]*x[1-9][0-9]*)$",
      "x-label-en": "Size",
      "x-label-zh": "尺寸",
      "x-constraints": {
        "max_aspect": 16,
        "max_pixels": 4624220,
        "min_aspect": 0.0625,
        "min_pixels": 921600
      }
    },
    "image": {
      "oneOf": [
        {
          "type": "string",
          "pattern": "^(https://|data:image/)"
        },
        {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^(https://|data:image/)"
          },
          "maxItems": 10,
          "minItems": 1
        }
      ],
      "x-tier": "common",
      "x-label-en": "Reference images",
      "x-label-zh": "参考图"
    },
    "prompt": {
      "type": "string",
      "x-tier": "common",
      "pattern": "\\S",
      "minLength": 1,
      "x-label-en": "Prompt",
      "x-label-zh": "提示词"
    },
    "watermark": {
      "type": "boolean",
      "x-tier": "advanced",
      "default": false,
      "x-label-en": "Watermark",
      "x-label-zh": "水印"
    },
    "background": {
      "enum": [
        "transparent",
        "opaque"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "opaque",
      "x-label-en": "Background",
      "x-label-zh": "背景"
    },
    "output_format": {
      "enum": [
        "jpeg",
        "png"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "jpeg",
      "x-label-en": "Output format",
      "x-label-zh": "输出格式"
    },
    "safety_identifier": {
      "type": "string",
      "x-tier": "advanced",
      "maxLength": 64,
      "minLength": 1,
      "x-label-en": "End-user ID",
      "x-label-zh": "终端用户标识"
    },
    "optimize_prompt_options": {
      "type": "object",
      "x-tier": "advanced",
      "default": {
        "mode": "standard"
      },
      "properties": {
        "mode": {
          "enum": [
            "standard",
            "fast"
          ],
          "type": "string",
          "x-tier": "advanced",
          "default": "standard",
          "x-label-en": "Mode",
          "x-label-zh": "模式"
        }
      },
      "x-label-en": "Prompt optimization",
      "x-label-zh": "提示词优化",
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
```
