Seedream 4.5 图像编辑

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "bytedance/seedream/v4.5/edit",
  "input": {
    "prompt": "Combine the three reference images into one natural photograph. Use the boy from image 1 with the same face, curly dark hair, freckles, red hooded raincoat with wooden toggles, navy trousers and yellow rubber boots. Use the exact toy sailboat from image 2: teal wooden hull with a white stripe, cream canvas sail with the stitched patch and dark blue painted star, red string at the bow. Place them on the misty loch shoreline from image 3. The boy crouches on the flat rocks at the water's edge, seen in three-quarter side view, gently setting the sailboat onto the calm water with both hands while holding the red string; small ripples spread around the hull. Keep the pebbles, rust bracken hills and misty pines of the location. Soft overcast morning light, consistent scale and shadows, realistic reflections in the water, a quiet tender moment, no text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "n": 1,
    "enable_safety_checker": true
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "GAPP1TYEWHR5CQVS",
    "status": "running",
    "created_time": "2026-09-25T16:16:53"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

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 @- <<EOF
{
  "model": "bytedance/seedream/v4.5/edit",
  "input": {
    "prompt": "Combine the three reference images into one natural photograph. Use the boy from image 1 with the same face, curly dark hair, freckles, red hooded raincoat with wooden toggles, navy trousers and yellow rubber boots. Use the exact toy sailboat from image 2: teal wooden hull with a white stripe, cream canvas sail with the stitched patch and dark blue painted star, red string at the bow. Place them on the misty loch shoreline from image 3. The boy crouches on the flat rocks at the water's edge, seen in three-quarter side view, gently setting the sailboat onto the calm water with both hands while holding the red string; small ripples spread around the hull. Keep the pebbles, rust bracken hills and misty pines of the location. Soft overcast morning light, consistent scale and shadows, realistic reflections in the water, a quiet tender moment, no text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "n": 1,
    "enable_safety_checker": true
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "GAPP1TYEWHR5CQVS",
    "status": "running",
    "created_time": "2026-09-25T16:16:53"
  }
}

{
  "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，都可以通过统一的查询任务状态接口获取结果。

使用 Seedream 4.5，通过文本提示词和 1-10 张参考图编辑图像，每次请求生成 1-15 张编辑后的图像。

模型

bytedance/seedream/v4.5/edit - 使用提示词和参考图编辑图像。

功能

使用提示词和参考图编辑图像。
image_urls 接受 1-10 张图像。
通过 n 控制输出图像数量。

输出选项

图像尺寸

size：可选。默认：1:1。
预设：2K、4K、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：必填。描述要做的修改。长度：1-3,000 个字符。
至少包含一个非空白字符。

图像 URL

image_urls：必填。提供公开可访问的图像 URL。1-10 项。每项都必须是指向 JPEG 或 PNG 图像的 HTTP(S) URL。

安全检查

enable_safety_checker：可选。设为 true 开启内容安全检查，设为 false 关闭。默认：true。

已验证示例

此示例通过 Vidgo 测试 API、使用 API Playground 中的 basic 请求生成。它按顺序组合了三张参考图：孩子、玩具帆船和湖岸。源图和结果图托管在 Vidgo CDN 上。参考图 1：孩子

{
  "code": 200,
  "data": {
    "task_id": "GAPP1TYEWHR5CQVS",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/output.jpg",
        "file_type": "image"
      }
    ],
    "created_time": "2026-09-25T16:16:53",
    "error_message": null,
    "progress": 100
  }
}

授权

Authorization

string

header

必填

使用 VIDGO_API_KEY。

请求体

application/json

model 和可选的 callback_url 放在请求根级，生成参数放在 input 内。

model

enum<string>

必填

可用选项:

bytedance/seedream/v4.5/edit

示例:

"bytedance/seedream/v4.5/edit"

input

object

必填

Show child attributes

callback_url

string | null

可选的公开 HTTP(S) URL，用于接收任务完成通知。

响应

任务已提交

code

enum<integer>

必填

可用选项:

200

data

object

必填

Show child attributes

​模型

​功能

​输出选项

​图像尺寸

​图像数量

​高级参数

​提示词

​图像 URL

​安全检查

​已验证示例

授权

请求体

响应

模型

功能