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/edit",
"input": {
"prompt": "Combine the three reference images into one natural documentary photograph. Use the elderly bookbinder from image 1 with exactly the same face, wrinkles, eyes, grey beard, navy galabeya, brown leather apron and silver cross. Use only the goatskin cover, gold-and-red interlaced cross, brass bosses and leather ties from image 2; do not copy the white table or the isolated still-life setup. Set the scene in the Cairo workshop from image 3 with its mashrabiya window, wooden press, shelves of quires and the ochre street beyond. The man stands in three-quarter view at the table, pressing the finished cover onto a text block in the wooden press. Relight him and the book with the same warm low afternoon sun from the left and matching lattice shadows, consistent scale and perspective, no text, no watermark.",
"size": "4:3",
"resolution": "2K",
"n": 1,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-02.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-03.png"
]
}
}
'{
"code": 200,
"data": {
"task_id": "MJH8FQO824KBO4VG",
"status": "running",
"created_time": "2026-09-26T10:59:58"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Seedream
Seedream 4 Edit
Transform images with Seedream 4 using multiple visual references, with batch variations and output up to 4K.
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/edit",
"input": {
"prompt": "Combine the three reference images into one natural documentary photograph. Use the elderly bookbinder from image 1 with exactly the same face, wrinkles, eyes, grey beard, navy galabeya, brown leather apron and silver cross. Use only the goatskin cover, gold-and-red interlaced cross, brass bosses and leather ties from image 2; do not copy the white table or the isolated still-life setup. Set the scene in the Cairo workshop from image 3 with its mashrabiya window, wooden press, shelves of quires and the ochre street beyond. The man stands in three-quarter view at the table, pressing the finished cover onto a text block in the wooden press. Relight him and the book with the same warm low afternoon sun from the left and matching lattice shadows, consistent scale and perspective, no text, no watermark.",
"size": "4:3",
"resolution": "2K",
"n": 1,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-02.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-03.png"
]
}
}
'{
"code": 200,
"data": {
"task_id": "MJH8FQO824KBO4VG",
"status": "running",
"created_time": "2026-09-26T10:59:58"
}
}{
"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 Edit
Transform images with Seedream 4 using multiple visual references, with batch variations and output up to 4K.Available Models
- bytedance/seedream/v4/edit - Edit images using a prompt and image references.
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.- The number of
image_urlsplusntotals 15 or fewer.
Key Features
- Edit images using a prompt and image references.
- Accepts 1-10 images in
image_urls. - 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.
Input image URLs use HTTP(S) and point to publicly accessible image files.
Prompt
prompt: Required. Describe the requested changes. Length: 1-5,000 characters.- Include at least one non-whitespace character.
Image URLs
image_urls: Required. Provide publicly accessible image URLs. Supply 1-10 items. Each item must be an HTTP(S) URL.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the request root. Place generation parameters inside input.