Seedream 4.5 Text to Image

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "bytedance/seedream/v4.5/text-to-image",
  "input": {
    "prompt": "A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: \"LAB\" (a scientist examining an ice core under a lamp), \"GALLEY\" (two people cooking soup at a steaming stove), \"BUNKS\" (stacked beds with colorful quilts), \"RADIO\" (an operator with headphones in front of dials), \"GREENHOUSE\" (lettuce and tomatoes under pink grow lights) and \"GARAGE\" (an orange snowcat being repaired). A banner across the top reads exactly \"AURORA RIDGE STATION\", and a small thermometer sign beside the entrance reads \"-38°C\". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark.",
    "size": "4:3",
    "n": 1,
    "enable_safety_checker": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "PGQCZ3X31DC6OEXQ",
    "status": "running",
    "created_time": "2026-09-25T16:14:03"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "bytedance/seedream/v4.5/text-to-image",
  "input": {
    "prompt": "A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: \"LAB\" (a scientist examining an ice core under a lamp), \"GALLEY\" (two people cooking soup at a steaming stove), \"BUNKS\" (stacked beds with colorful quilts), \"RADIO\" (an operator with headphones in front of dials), \"GREENHOUSE\" (lettuce and tomatoes under pink grow lights) and \"GARAGE\" (an orange snowcat being repaired). A banner across the top reads exactly \"AURORA RIDGE STATION\", and a small thermometer sign beside the entrance reads \"-38°C\". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark.",
    "size": "4:3",
    "n": 1,
    "enable_safety_checker": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "PGQCZ3X31DC6OEXQ",
    "status": "running",
    "created_time": "2026-09-25T16:14:03"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Develop visual concepts with Seedream 4.5, generating multiple images from a prompt to explore different styles and compositions.

Models

bytedance/seedream/v4.5/text-to-image - Generate images from text prompts.

Features

Generate images from text prompts.
Control the number of output images with n.

Output Options

Image Size

size: Optional. Default: 1:1.
Presets: 2K, 4K, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9.
For custom dimensions, supply an object with integer width and height; both must be positive.
Custom dimensions also accept a WIDTHxHEIGHT string, using x or X between the positive dimensions.

Image Count

n: Optional. Number of images to generate. Integer from 1 to 15. Default: 1.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.

Prompt

prompt: Required. Describe the desired image. Length: 1-3,000 characters.
Include at least one non-whitespace character.

Safety Checker

enable_safety_checker: Optional. Set true to enable the content safety check or false to disable it. Default: true.

Verified Example

This example was generated through the Vidgo test API with the basic request shown in the API playground. The result image is hosted on the Vidgo CDN. Aurora Ridge Station Cutaway

{
  "code": 200,
  "data": {
    "task_id": "PGQCZ3X31DC6OEXQ",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/text-to-image/v1/01/output.jpg",
        "file_type": "image"
      }
    ],
    "created_time": "2026-09-25T16:14:03",
    "error_message": null,
    "progress": 100
  }
}

Authorizations

Authorization

string

header

required

Use VIDGO_API_KEY.

Body

application/json

Set model and optional callback_url at the request root. Place generation parameters inside input.

model

enum<string>

required

Available options:

bytedance/seedream/v4.5/text-to-image

Example:

"bytedance/seedream/v4.5/text-to-image"

input

object

required

Show child attributes

callback_url

string | null

Optional public HTTP(S) URL for task completion notifications.

Response

Task submitted

code

enum<integer>

required

Available options:

200

data

object

required

Show child attributes

​Models

​Features

​Output Options

​Image Size

​Image Count

​Advanced Parameters

​Prompt

​Safety Checker

​Verified Example

Authorizations

Body

Response

Models

Features

Output Options

Image Size

Image Count

Advanced Parameters

Prompt

Safety Checker

Verified Example