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

Seedream 5.0 Pro Image to Image API

POST /v1/tasks

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

模型概览

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

HiAPI 旗舰图生图模型:最多 10 张参考图做改图与多图融合,角色、产品与风格保持一致,按 basic/high 质量档位输出。

生产建议

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

适用场景

一致性改图

改场景、换风格时保住布局、主体与图内文字;把「保持不变」的元素明确写进指令(实测雨夜街景改晴天,店招文字与人物位置完整保留)。

promptimage_urls
多参考融合

最多 10 张参考图,把不同图的人物、产品与场景融合成一张,主体一致性好;指令里写清每张图承担的角色。

image_urls
分档控制成本

basic 输出 1K 图像,售价 $0.05/张;high 输出 2K 图像,售价 $0.10/张。按质量档位分档计费。

quality

请求参数

model string 必填

固定填 seedream-5.0-pro/image-to-image。

示例 seedream-5.0-pro/image-to-image
input object 必填

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

prompt string 必填

描述期望输出的编辑或生成指令,长度 4-5000 字符。

image_urls string[] 必填

输入参考图 URL 数组,1-10 张,用于单图改写或多参考生成与融合。支持 JPG/PNG/WebP,每张最大 10MB,不支持 SVG。

aspect_ratio enum 必填

生成图像的宽高比。

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

输出质量档位。basic 输出 1K 图像,售价 $0.05/张;high 输出 2K 图像,售价 $0.10/张。

默认 basic 可选值: basichigh
output_format enum 可选

输出图片格式。

默认 png 可选值: pngjpeg
callback object 可选

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

url string 必填

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

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

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

默认 final 可选值: final

用例示例

雨夜改晴天(保布局保文字)

16:9 / high,场景重塑同时保留街道布局与招牌文字。

请求体
{
  "model": "seedream-5.0-pro/image-to-image",
  "input": {
    "prompt": "Turn this rainy cyberpunk night market into a bright sunny morning scene, keep the same street layout and glowing storefront sign text unchanged",
    "image_urls": [
      "https://static.hiapi.ai/previews/seedream-5.0-pro/2026/07/09/1783562443968-9f2774efdd1a6516-example-i2i-in.webp"
    ],
    "aspect_ratio": "16:9",
    "quality": "high"
  }
}
多参考融合(人物 + 场景)

两张参考图各取所需,融合成一张;指令写清每张图的角色。

请求体
{
  "model": "seedream-5.0-pro/image-to-image",
  "input": {
    "prompt": "把图1的人物放进图2的场景,保持人物长相、服装与图2的光线氛围一致",
    "image_urls": [
      "https://example.com/person.jpg",
      "https://example.com/scene.jpg"
    ],
    "aspect_ratio": "16:9",
    "quality": "high"
  }
}

获取结果

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

常见问题

参考图有什么要求?最多几张?

1-10 张图片 URL,支持 JPG/PNG/WebP,每张最大 10MB,不支持 SVG。多参考融合时在指令里写清每张图承担的角色,融合效果更稳。

改图时能保留原图的文字和布局吗?

可以。把「保持不变」的元素明确写进指令,例如「保持街道布局和店招文字不变」;实测雨夜改晴天场景中招牌文字与人物位置完整保留。

basic 和 high 价格一样吗?

basic 输出 1K 图像,售价 $0.05/张;high 输出 2K 图像,售价 $0.10/张。按质量档位分档计费,迭代阶段用 basic,正式交付再切 high。 查看价格

下一步