跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Seedream 4.5 Image to Image API

POST /v1/tasks

所有模型都通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 seedream-4.5/image-to-image
类型 图像生成（图生图）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Seedream 4.5 图像编辑:生成编辑一体,最多 14 张参考图做改图、换景与多图融合,主体与文字一致,按张计费。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

多参考图融合

一次最多 14 张参考图,按序号引用做多图合成与角色一致性。

image_urlsprompt
场景与季节改造

换背景、换季节、换氛围,主体与图内文字保持不变。

prompt
生成编辑一体

编辑输出与文生图同代画质,改图不掉质感。

promptresolution
按张计费

价格与参考图数量、分辨率无关,批量编辑成本可控。

resolution

请求参数

model string 必填

固定填 seedream-4.5/image-to-image。

示例 seedream-4.5/image-to-image
input object 必填

业务参数对象；Seedream 4.5 Image to Image 的模型专属配置都放在这里。

prompt string 必填

编辑指令,最长 3000 字符,可按序号引用参考图。

image_urls string[] 必填

参考图 URL 数组,1-14 张;jpeg/png/webp,不支持 svg,单张最大 10MB。

aspect_ratio enum 必填

生成图片的宽高比。

默认 1:1 可选值: 1:14:33:416:99:162:33:221:9
resolution enum 必填

输出分辨率:2K 标准 / 4K 超清。

默认 2K 可选值: 2K4K
callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

季节改造(雪夜拉面店)

保持店面与书法文字,整体改成大雪冬夜,实测。

请求体
{
  "model": "seedream-4.5/image-to-image",
  "input": {
    "prompt": "Change the season to heavy winter snowfall: snow accumulating on the signboard and street, warm lantern glow contrasting the cold blue night, keep the storefront layout and calligraphy text unchanged",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/220f90f15f629434.jpg"
    ],
    "aspect_ratio": "3:4",
    "resolution": "2K"
  }
}
双图合成(雪豹与冰瓶,4K)

图 1 产品放进图 2 场景,光线匹配,实测。

请求体
{
  "model": "seedream-4.5/image-to-image",
  "input": {
    "prompt": "Place the ice-carved perfume bottle from image 1 onto the rocky ledge beside the snow leopard in image 2, matching the dawn alpine lighting and cold atmosphere, seamless composite, keep both subjects photorealistic",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/c2a64356e31c2205.jpg",
      "https://static.hiapi.ai/gallery/2026/07/5d186d631d3ba69a.jpg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "4K"
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的图片。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

最多几张参考图?

1-14 张(jpeg/png/webp,单张 ≤10MB),在 prompt 里按"图 1/图 2"引用。

参考图数量影响价格吗?

不影响,按输出张数计费,2K/4K 同价。

和 flux-2/image-to-image 怎么选?

两者都是多参考图编辑:Seedream 4.5 支持 14 张参考图和中文文字保持;FLUX.2 编辑最多 8 张、写实一致性强。可按素材语言与风格试后选。

下一步