Skip to main content
POST
  1. 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.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
Generate image sets with Seedream 4, with output up to 4K for illustrations, design concepts, and visual variations.

Models

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

Features

  • Generate images from text prompts.
  • Choose from 1K, 2K, 4K output resolutions.
  • Control the number of output images with n.

Output Options

Image Size

  • size: Optional. Accepted values: 1:1, 3:4, 4:3, 16:9, 9:16, 3:2, 2:3, 21:9. Default: 1:1.

Resolution

  • resolution: Optional. Accepted values: 1K, 2K, 4K. Default: 2K.

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-5,000 characters.
  • Include at least one non-whitespace character.

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/text-to-image
Example:

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

input
object
required
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