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 图像编辑
Seedream 5.0 Lite 图像编辑 API 通过文字指令和多张参考图重新混编已有画面，支持批量输出。
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>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- bytedance/seedream/v5/lite/edit - 使用提示词和参考图编辑图像。
功能
- 使用提示词和参考图编辑图像。
image_urls接受 1-10 张图像。- 通过
n控制输出图像数量。
输出选项
图像尺寸
size：可选。默认：1:1。- 预设：
2K、3K、1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9。 - 自定义尺寸时，提供包含整数
width和height的对象，两者都必须为正数。 - 自定义尺寸也可以使用
WIDTHxHEIGHT字符串，两个正数之间用x或X分隔。
图像数量
n：可选。要生成的图像数量。1到15的整数。默认：1。
高级参数
model 和可选的 callback_url 放在请求根级。所有工作流参数（包括输出选项）都放在 input 内。
输入图像 URL 使用 HTTP(S)，并指向公开可访问的 JPEG 或 PNG 文件。
提示词
prompt：必填。描述要做的修改。长度：3-3,000 个字符。- 长度按去除首尾空白后计算。
图像 URL
image_urls：必填。提供公开可访问的图像 URL。1-10 项。每项都必须是指向 JPEG 或 PNG 图像的 HTTP(S) URL。
安全检查
enable_safety_checker：可选。设为true开启内容安全检查，设为false关闭。默认：true。
授权
使用 VIDGO_API_KEY。
请求体
application/json