# Seedream 5.0 Lite

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

- **Model ID**: `bytedance/seedream-5.0-lite`
- **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-lite

## Pricing

| Tier | Official / image | Kerox / image | Savings |
| --- | --- | --- | --- |
| Default | $0.0350 | $0.0315 | 10% |

- **Image sets**: with image sets on, every generated image is billed at this price, up to 15 per task. The hold covers the most the task may generate; the charge follows the actual count.

## 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-lite",
  "input": {
    "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
    "size": "2048x2048"
  },
  "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-lite",
        "input": {
            "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
            "size": "2048x2048",
        },
        "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-lite",
    "input": {
      "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
      "size": "2048x2048"
    },
    "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-lite",
  "input": {
    "prompt": "editorial portrait of a ceramicist in morning sunlight, 35mm film",
    "size": "2048x2048"
  },
  "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 | `"2048x2048"` | — | Size |
| `image` | string \| string[] | — | — | Reference images |
| `prompt` | string | — | — | Prompt |
| `watermark` | boolean | `false` | — | Watermark |
| `output_format` | string | `"jpeg"` | jpeg, png | Output format |
| `optimize_prompt_options` | object | `{"mode":"standard"}` | — | Prompt optimization |
| `sequential_image_generation` | string | `"disabled"` | auto, disabled | Image set mode |
| `sequential_image_generation_options` | object | — | — | Image set options |

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

| Parameter | Type | Default | Values | Description |
| --- | --- | --- | --- | --- |
| `n` | integer | `1` | 1–15 | Number of outputs |
| `images` | string \| string[] | — | — | Reference images |
| `prompt` | string | — | — | Prompt |
| `resolution` | string | `"2K"` | 2K, 3K, 4K | Resolution |
| `aspect_ratio` | string | `"auto"` | auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 16:9, 21:9, 9:16, 9:21 | Aspect ratio |
| `watermark` | boolean | `false` | — | Watermark |
| `output_format` | string | `"jpeg"` | jpeg, png | Output format |
| `optimize_prompt_options` | object | `{"mode":"standard"}` | — | Prompt optimization |
| `sequential_image_generation_options` | object | — | — | Image set options |

## 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-lite",
  "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",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "prompt"
  ],
  "properties": {
    "size": {
      "type": "string",
      "x-tier": "common",
      "default": "2048x2048",
      "pattern": "^(2K|3K|4K|[1-9][0-9]*x[1-9][0-9]*)$",
      "x-label-en": "Size",
      "x-label-zh": "尺寸",
      "x-constraints": {
        "max_aspect": 16,
        "max_pixels": 16777216,
        "min_aspect": 0.0625,
        "min_pixels": 3686400
      }
    },
    "image": {
      "oneOf": [
        {
          "type": "string",
          "pattern": "^(https://|data:image/)"
        },
        {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^(https://|data:image/)"
          },
          "maxItems": 14,
          "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": "水印"
    },
    "output_format": {
      "enum": [
        "jpeg",
        "png"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "jpeg",
      "x-label-en": "Output format",
      "x-label-zh": "输出格式"
    },
    "optimize_prompt_options": {
      "type": "object",
      "x-tier": "advanced",
      "default": {
        "mode": "standard"
      },
      "properties": {
        "mode": {
          "enum": [
            "standard"
          ],
          "type": "string",
          "x-tier": "advanced",
          "default": "standard",
          "x-label-en": "Mode",
          "x-label-zh": "模式"
        }
      },
      "x-label-en": "Prompt optimization",
      "x-label-zh": "提示词优化",
      "additionalProperties": false
    },
    "sequential_image_generation": {
      "enum": [
        "auto",
        "disabled"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "disabled",
      "x-label-en": "Image set mode",
      "x-label-zh": "顺序组图"
    },
    "sequential_image_generation_options": {
      "type": "object",
      "x-tier": "advanced",
      "properties": {
        "max_images": {
          "type": "integer",
          "x-tier": "advanced",
          "default": 15,
          "maximum": 15,
          "minimum": 1,
          "x-label-en": "Max images",
          "x-label-zh": "最多张数"
        }
      },
      "x-label-en": "Image set options",
      "x-label-zh": "组图选项",
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
```
