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 图像编辑
Seedream 4 图像编辑 API 结合多张视觉参考改造图像，支持批量变体，输出最高 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>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- bytedance/seedream/v4/edit - 使用提示词和参考图编辑图像。
功能
- 使用提示词和参考图编辑图像。
image_urls接受 1-10 张图像。- 可选
1K、2K、4K输出分辨率。 - 通过
n控制输出图像数量。
输出选项
图像尺寸
size：可选。可选值：1:1、3:4、4:3、16:9、9:16、3:2、2:3、21:9。默认：1:1。
分辨率
resolution：可选。可选值：1K、2K、4K。默认：2K。
图像数量
n：可选。要生成的图像数量。1到15的整数。默认：1。image_urls数量与n之和不超过 15。
高级参数
model 和可选的 callback_url 放在请求根级。所有工作流参数（包括输出选项）都放在 input 内。
输入图像 URL 使用 HTTP(S)，并指向公开可访问的图像文件。
提示词
prompt：必填。描述要做的修改。长度：1-5,000 个字符。- 至少包含一个非空白字符。
图像 URL
image_urls：必填。提供公开可访问的图像 URL。1-10 项。每项都必须是 HTTP(S) URL。
授权
使用 VIDGO_API_KEY。
请求体
application/json