Skip to content

Doubao Seedream 5.0 Lite Image Generation

ByteDance's latest Seedream 5.0 Lite model, the first to support web-search-assisted image generation, with 2K/3K/4K multi-resolution and multi-image mode, delivering leading image quality and timeliness.

Quick Start

python
from openai import OpenAI

client = OpenAI(
    base_url="https://open.dieyuyun.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.images.generate(
    model="doubao-seedream-5.0-lite",
    prompt="An orange tabby cat sitting on a windowsill watching the rain, watercolor style, warm tones",
    size="4096x4096",
    n=1
)

print(response.data[0].url)

Endpoint

ItemValue
MethodPOST
Path/v1/images/generations
Base URLhttps://open.dieyuyun.com
ProtocolOpenAI Images API

Authentication

Bearer Token: Authorization: Bearer YOUR_API_KEY

Standard Request Fields

FieldTypeRequiredDefaultDescription
modelstringYesModel identifier: doubao-seedream-5.0-lite
promptstringYesImage description text, supports Chinese and English, recommended under 300 Chinese characters
sizestringNo4096x4096Image size (width x height in pixels)
nintegerNo1Number of images to generate (max 15). When >1, multi-image mode is enabled
response_formatstringNourlResponse format: url or b64_json

Supported Sizes

Doubao Seedream 5.0 Lite supports three resolution tiers: 2K, 3K (exclusive to 5.0 Lite), and 4K (default).

2K Resolution

SizeAspect Ratio
2048x20481:1
2304x17284:3
1728x23043:4
2848x160016:9
1600x28489:16
2496x16643:2
1664x24962:3
3136x134421:9

3K Resolution (Exclusive to 5.0 Lite)

SizeAspect Ratio
3072x30721:1
3456x25924:3
2592x34563:4
4096x230416:9
2304x40969:16
3744x24963:2
2496x37442:3
4704x201621:9

4K Resolution (Default)

SizeAspect Ratio
4096x40961:1
4704x35204:3
3520x47043:4
5504x304016:9
3040x55049:16
4992x33283:2
3328x49922:3
6240x265621:9

Extended Parameters

FieldTypeRequiredDefaultDescription
imagestring/arrayNoReference image URLs or Base64, up to 14
watermarkbooleanNofalseWhether to add an AI-generated watermark
sequential_image_generationstringNodisabledauto for multi-image mode / disabled for single image
output_formatstringNojpegOutput image format: jpeg or png (4.5/4.0 always output jpeg)
tools_web_searchbooleanNofalseEnable web-search-assisted generation for up-to-date images (increases latency)

Request Examples

bash
curl https://open.dieyuyun.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5.0-lite",
    "prompt": "An orange tabby cat sitting on a windowsill watching the rain, watercolor style, warm tones",
    "size": "4096x4096",
    "n": 1
  }'
python
from openai import OpenAI

client = OpenAI(
    base_url="https://open.dieyuyun.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.images.generate(
    model="doubao-seedream-5.0-lite",
    prompt="An orange tabby cat sitting on a windowsill watching the rain, watercolor style, warm tones",
    size="4096x4096",
    n=1
)

print(response.data[0].url)
javascript
import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://open.dieyuyun.com/v1',
  apiKey: 'YOUR_API_KEY',
})

const response = await client.images.generate({
  model: 'doubao-seedream-5.0-lite',
  prompt: 'An orange tabby cat sitting on a windowsill watching the rain, watercolor style, warm tones',
  size: '4096x4096',
  n: 1,
})

console.log(response.data[0].url)

Response Format

Success Response

json
{
  "created": 1717000000,
  "model": "doubao-seedream-5.0-lite",
  "data": [
    {
      "url": "https://...",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384,
    "tool_usage": {
      "web_search": 0
    }
  }
}
FieldTypeDescription
createdintegerUnix timestamp
modelstringModel identifier
dataarrayArray of generated results
data[].urlstringImage URL
data[].sizestringActual generated image dimensions
usageobjectUsage statistics
usage.generated_imagesintegerNumber of images generated
usage.output_tokensintegerOutput token count
usage.total_tokensintegerTotal token count
usage.tool_usageobjectTool usage statistics
usage.tool_usage.web_searchintegerWeb search call count (when tools_web_search is enabled)

Error Response

See Error Codes for details.

Exclusive Features of 5.0 Lite

Web-Search-Assisted Generation

Doubao Seedream 5.0 Lite is the first to support web-search-assisted image generation. When tools_web_search is enabled, the model can search internet content as a reference for image generation, significantly improving the timeliness and accuracy of generated images.

python
response = client.images.generate(
    model="doubao-seedream-5.0-lite",
    prompt="Latest sneaker designs of 2025",
    size="4096x4096",
    tools_web_search=True
)

3K Resolution

The exclusive 3K resolution tier strikes the best balance between image quality and generation speed, making it ideal for everyday use cases.

python
response = client.images.generate(
    model="doubao-seedream-5.0-lite",
    prompt="City skyline at sunset",
    size="3072x3072"
)

PNG Output

Supports setting output_format to png for scenarios that require lossless output (e.g., print materials, transparent backgrounds). Versions 4.5 and 4.0 always output jpeg.

python
response = client.images.generate(
    model="doubao-seedream-5.0-lite",
    prompt="Logo design, clean and modern",
    size="4096x4096",
    output_format="png"
)

Best Practices

  • Web search: Ideal for time-sensitive scenarios such as trending events, latest products, and current-affairs-related image generation. Note that enabling it increases generation latency.
  • 3K resolution: Best suited for everyday use, striking the optimal balance between image quality and generation speed. Switch to 4K when ultimate image fidelity is required.
  • Multi-image mode: Set n > 1 or sequential_image_generation: "auto" to generate a series of images, perfect for sequential illustrations, storyboards, or stylistically consistent asset sets.
  • Prompt tips: Supports mixed Chinese and English prompts. Keep prompts under 300 Chinese characters. The more specific the description, the better the output.
  • Reference images: Upload reference images (up to 14) via the image parameter to guide the model toward stylistically consistent output.

Rate Limits

See Rate Limits for details.