curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "bytedance/seedream/v5/lite/edit",
"input": {
"prompt": "Combine the three reference images into one natural documentary photograph. Use the elderly woman from image 1 with exactly the same face, wrinkles, eyes, braids tied with red yarn, black montera hat with the red band and magenta shawl with the silver pin. Use the backstrap loom and half-finished textile from image 2, keeping the same red, deep green and golden yellow diamond and zigzag pattern with the small white llama figures. Set the scene in the adobe courtyard from image 3 with its ochre walls, blue door, clay pot of geraniums and the terraces and snowy peaks beyond the low wall. The woman kneels on the straw mat in three-quarter view; the far end bar of the loom is tied to the wooden post, the near bar is attached to a strap around her waist, and her hands pass the weaving sword through the warp threads. Relight her and the loom with the same warm low afternoon sun from the left and matching long shadows, consistent scale and perspective, no text, no watermark.",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v5/lite/edit/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v5/lite/edit/v1/01/input-02.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v5/lite/edit/v1/01/input-03.png"
],
"size": "4:3",
"n": 1,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "MYBFV6M8G3QZ4W4C",
"status": "running",
"created_time": "2026-09-25T16:21:48"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Seedream
Seedream 5.0 Lite Edit
Remix existing visuals with Seedream 5.0 Lite using text instructions and multiple reference images, with support for batch output.
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/v5/lite/edit",
"input": {
"prompt": "Combine the three reference images into one natural documentary photograph. Use the elderly woman from image 1 with exactly the same face, wrinkles, eyes, braids tied with red yarn, black montera hat with the red band and magenta shawl with the silver pin. Use the backstrap loom and half-finished textile from image 2, keeping the same red, deep green and golden yellow diamond and zigzag pattern with the small white llama figures. Set the scene in the adobe courtyard from image 3 with its ochre walls, blue door, clay pot of geraniums and the terraces and snowy peaks beyond the low wall. The woman kneels on the straw mat in three-quarter view; the far end bar of the loom is tied to the wooden post, the near bar is attached to a strap around her waist, and her hands pass the weaving sword through the warp threads. Relight her and the loom with the same warm low afternoon sun from the left and matching long shadows, consistent scale and perspective, no text, no watermark.",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v5/lite/edit/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v5/lite/edit/v1/01/input-02.png",
"https://cdn.vidgo.ai/apis/models/bytedance/seedream/v5/lite/edit/v1/01/input-03.png"
],
"size": "4:3",
"n": 1,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "MYBFV6M8G3QZ4W4C",
"status": "running",
"created_time": "2026-09-25T16:21:48"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Models
- bytedance/seedream/v5/lite/edit - Edit images using a prompt and image references.
Features
- Edit images using a prompt and image references.
- Accepts 1-10 images in
image_urls. - Control the number of output images with
n.
Output Options
Image Size
size: Optional. Default:1:1.- Presets:
2K,3K,1:1,4:3,3:4,16:9,9:16,3:2,2:3,21:9. - For custom dimensions, supply an object with integer
widthandheight; both must be positive. - Custom dimensions also accept a
WIDTHxHEIGHTstring, usingxorXbetween the positive dimensions.
Image Count
n: Optional. Number of images to generate. Integer from1to15. Default:1.
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 JPEG or PNG files.
Prompt
prompt: Required. Describe the requested changes. Length: 3-3,000 characters.- Length is counted after leading and trailing whitespace is trimmed.
Image URLs
image_urls: Required. Provide publicly accessible image URLs. Supply 1-10 items. Each item must be an HTTP(S) URL pointing to a JPEG or PNG image.
Safety Checker
enable_safety_checker: Optional. Settrueto enable the content safety check orfalseto disable it. Default:true.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the request root. Place generation parameters inside input.