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/text-to-image",
"input": {
"prompt": "A cinematic documentary photograph inside a historic sulfur bath house in the Abanotubani district of Tbilisi, Georgia, mid-afternoon. In the foreground, an older Georgian attendant in a white cotton wrap and rubber sandals kneels at the rim of a hexagonal stone pool, testing the water with the back of his hand; steam wraps around his forearm. In the middle ground, a younger woman sits on a marble bench with a folded striped towel over her shoulders, her face half-hidden by a drifting steam veil, talking to a friend who is only visible as a silhouette behind a brick arch. In the far background, a high oculus window drops a single hard shaft of daylight onto the wet brick floor, making the steam glow. Correct occlusion between the three figures, every highlight coming from that one oculus, wet stone texture, visible condensation on the brick vault, 35mm lens, natural skin texture, believable hands with five fingers, no text, no logos, no watermark.",
"size": "3:2",
"resolution": "2K",
"n": 1
}
}
'{
"code": 200,
"data": {
"task_id": "KM1JC58S12F3BATH",
"status": "running",
"created_time": "2026-09-26T10:59:51"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Seedream
Seedream 4 Text to Image
Generate image sets with Seedream 4, with output up to 4K for illustrations, design concepts, and visual variations.
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/text-to-image",
"input": {
"prompt": "A cinematic documentary photograph inside a historic sulfur bath house in the Abanotubani district of Tbilisi, Georgia, mid-afternoon. In the foreground, an older Georgian attendant in a white cotton wrap and rubber sandals kneels at the rim of a hexagonal stone pool, testing the water with the back of his hand; steam wraps around his forearm. In the middle ground, a younger woman sits on a marble bench with a folded striped towel over her shoulders, her face half-hidden by a drifting steam veil, talking to a friend who is only visible as a silhouette behind a brick arch. In the far background, a high oculus window drops a single hard shaft of daylight onto the wet brick floor, making the steam glow. Correct occlusion between the three figures, every highlight coming from that one oculus, wet stone texture, visible condensation on the brick vault, 35mm lens, natural skin texture, believable hands with five fingers, no text, no logos, no watermark.",
"size": "3:2",
"resolution": "2K",
"n": 1
}
}
'{
"code": 200,
"data": {
"task_id": "KM1JC58S12F3BATH",
"status": "running",
"created_time": "2026-09-26T10:59:51"
}
}{
"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. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - 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 Text to Image
Generate image sets with Seedream 4, with output up to 4K for illustrations, design concepts, and visual variations.Available Models
- bytedance/seedream/v4/text-to-image - Generate images from text prompts.
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 from1to15. Default:1.
Key Features
- Generate images from text prompts.
- Choose from
1K,2K,4Koutput resolutions. - Control the number of output images with
n.
Advanced Parameters
Setmodel 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
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the request root. Place generation parameters inside input.