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

Seedream 5.0 Lite Image to Image API

POST /v1/tasks

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

模型概览

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

字节跳动 Seedream 5.0 Lite 图生图编辑：按自然语言指令改图，最多 14 张参考图，未提及区域保持原样，支持改文字、换材质与多图合成，2K 与 4K 同价。

生产建议

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

适用场景

指令级图片编辑

用自然语言描述要改什么：换色调、加元素、调光影，指令未提及的区域保持原样，适合海报改版与商品图微调。

promptimage_urls
画面文字改写

直接改写图中招牌、标题等文字，保持原字体风格与发光效果，中英双语可在同一次编辑里完成。

prompt
多参考图合成

最多 14 张参考图，按「第一张图的 X + 第二张图的 Y」句式融合不同素材，输出仍按一张图计费。

image_urls
材质与风格替换

玻璃换冰雕、白天改雨夜这类整体材质/氛围转换，保持构图与主体位置不变。

prompt

请求参数

model string 必填

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

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

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

prompt string 必填

编辑指令，3–3000 字符：写清要改什么、保持什么。指令未提及的区域会尽量保持原样。

image_urls string[] 必填

参考图 URL 数组，1–14 张；支持 JPEG/PNG/WebP，单张不超过 10MB。按输出张数计费，与参考图数量无关。

aspect_ratio enum 必填

输出图片的宽高比。

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

输出分辨率档位：2K 标准档（长边约 2300px），4K 超清档（长边约 4096px，实测），两档同价。

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

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

url string 必填

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

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

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

默认 final 可选值: final

用例示例

海报改色 + 加印章（指令编辑）

保持版式与主体，只换色调并新增一个元素。

请求体
{
  "model": "seedream-5.0-lite/image-to-image",
  "input": {
    "prompt": "保持海报版式、书法标题与青铜鼎不变，把色调从做旧金+深青换成深绯红+象牙白，并在右下角加一枚低调的红色蜡封印章",
    "image_urls": [
      "https://static.hiapi.ai/previews/seedream-5.0-lite/2026/07/03/1783057555249-f76441ce83f6c0d6-seedream-lite-t2i-g1-bronze.webp"
    ],
    "aspect_ratio": "3:4",
    "resolution": "2K"
  }
}
玻璃棋变冰雕（材质替换）

整体材质与背景氛围替换，棋子位置保持不变。

请求体
{
  "model": "seedream-5.0-lite/image-to-image",
  "input": {
    "prompt": "把玻璃棋子变成由内发光的冰雕，背景改为品红与祖母绿的绚烂极光风暴夜空，保持木桌与所有棋子位置不变，棋盘覆霜，空气中漂浮细小冰晶",
    "image_urls": [
      "https://static.hiapi.ai/previews/seedream-5.0-lite/2026/07/03/1783057569706-dbb85f6269c1f5c0-seedream-lite-i2i-input-chess.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "4K"
  }
}
双图全息合成（多参考图）

两张参考图融合成一个新场景。

请求体
{
  "model": "seedream-5.0-lite/image-to-image",
  "input": {
    "prompt": "融合两张参考图：把第一张图中的青铜鼎变成巨大的半透明青色全息投影，悬浮在第二张图的雨夜霓虹街道上空，打伞的人群仰望，保持街道霓虹招牌清晰可读",
    "image_urls": [
      "https://static.hiapi.ai/previews/seedream-5.0-lite/2026/07/03/1783057555249-f76441ce83f6c0d6-seedream-lite-t2i-g1-bronze.webp",
      "https://static.hiapi.ai/previews/seedream-5.0-lite/2026/07/03/1783057274330-5b12897efad48ccd-seedream-lite-t2i-cover.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "4K"
  }
}

获取结果

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

常见问题

最多支持几张参考图？多图会更贵吗？

最多 14 张参考图，支持 JPEG/PNG/WebP、单张不超过 10MB。按输出张数计费，与参考图数量无关，实时价格见价格页。 查看价格

怎么让编辑只改我要的部分？

在指令里明确写出「保持不变」的部分（例如「保持版式与主体位置不变」），模型对未提及区域会尽量保持原样；要改的内容说得越具体，结果越稳。

能修改图片里的文字吗？

可以。指出原文字和新文字即可（例如「把招牌 NIGHT NOODLES 改成 MIDNIGHT RAMEN」），模型会保持原字体风格、发光颜色与位置，中英双语可以在同一次编辑完成。

怎么拿到编辑后的图片？

提交后立即返回 taskId，任务进入终态后从 output[].url 下载图片。生产环境建议在请求体顶层传 callback.url 收终态通知，减少无效轮询。

下一步