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>"
}

Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Seedream 4.5 Text to Image

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

Available Models

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

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.

Key Features

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

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

Overview

Chat Series

Image Series

Video Series

Music Series

3D Series

File Management

Task Management

Account Management

Seedream 4.5 Text to Image

Seedream 4.5 Text to Image

Available Models

Output Options

Image Size

Image Count

Key Features

Advanced Parameters

Prompt

Safety Checker

Verified Example

Authorizations

Body

Response

​Seedream 4.5 Text to Image

​Available Models

​Output Options

​Image Size

​Image Count

​Key Features

​Advanced Parameters

​Prompt

​Safety Checker

​Verified Example

Authorizations

Body

Response

Seedream 4.5 Text to Image

Available Models

Output Options

Image Size

Image Count

Key Features

Advanced Parameters

Prompt

Safety Checker

Verified Example