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

Seedream 5.0 Flash

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 seedream-5.0-flash
类型 图像生成与编辑（文生图 / 图生图）
接口 POST /v1/tasks
价格 见 HiAPI 定价

通过同一模型生成或编辑图片，支持多参考图融合、档位尺寸和自定义画布。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，任务结束后接收通知；不要把 callback 放进 input。
  • callback.when 使用 final；success 和 fail 都会进入终态，接收端应按 taskId 做幂等处理。
  • 本地调试或回调遗漏时，可通过 GET /v1/tasks/:id 查询；拿到 taskId 后应查询原任务，避免重复提交。

适用场景

产品场景图

描述主体、材质、背景与照明，不传 image 即可按文字生成一张图片。

prompt
多画幅内容

用 size 指定横版封面、竖版海报或方形配图的像素尺寸。

size
参考图编辑与融合

提供一张图时说明修改和保留项；提供多张图时，在提示词中说明各图的主体、背景或风格用途。

promptimage

请求参数

model string 必填

固定填写 seedream-5.0-flash。

示例 seedream-5.0-flash
input object 必填

图片生成和编辑参数。

prompt string 必填

描述生成画面，或结合参考图说明修改项与保留项。1–5000 个字符。

image string | string[] 可选

单个图片 URL、Base64 data URL 或 1–10 张图片数组；不传时按文字生成。每张不超过 30MB，支持 JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF；宽高须大于 14px，总像素 196–36000000，宽高比 1:16–16:1。

size string 可选

填写 1K、1.5K、2K 档位，或用英文小写 x 连接宽高像素，例如 1536x1024（3:2 横图）、1152x2048（9:16 竖图）、2048x2048（方图）。自定义尺寸总像素须为 921600–4624220，宽高比须在 1:16–16:1 之间；不支持 4K。 查看常用尺寸示例

默认 2K 示例 1536x1024
output_format enum 可选

选择文件格式。省略时通常为 JPEG，透明背景时为 PNG。

可选值: jpegpng
background enum 可选

opaque 为普通背景；transparent 仅用于编辑一张带透明通道的图片，输出格式须为 PNG 或不指定。

默认 opaque 可选值: opaquetransparent
watermark boolean 可选

是否在图片中添加 AI 生成水印。默认关闭；传 true 开启。

默认 false
callback object 可选

任务终态通知。

url string 必填

接收通知的 HTTPS 地址。

when enum 可选

任务结束时通知。

默认 final 可选值: final

size 尺寸示例

以下像素尺寸均符合参数范围，可直接作为 size 字符串使用。档位值（如 2K）不是固定的宽高；需要指定画幅时使用宽x高，不要把 16:9 等比例直接传给 size。

用途宽高比size 值
方形配图1:11024x1024
方形高清图1:12048x2048
横版产品图3:21536x1024
竖版海报2:31024x1536
横版封面16:92048x1152
竖版封面9:161152x2048

用例示例

晨光中的陶瓷茶壶

用主体、材质和照明描述生成产品场景。

请求体
{
  "model": "seedream-5.0-flash",
  "input": {
    "prompt": "Studio product photograph of a matte teal ceramic teapot with a curved walnut handle, on pale limestone, soft morning window light, subtle steam, warm cream background, realistic material texture, no text.",
    "size": "2K",
    "watermark": false
  }
}
自定义横版封面

2048x1152、16:9 横图，输出 PNG，水印关闭。

请求体
{
  "model": "seedream-5.0-flash",
  "input": {
    "prompt": "A minimalist landscape cover with an orange folded-paper sculpture on a warm cream background, directional studio light, generous negative space on the left, no text.",
    "size": "2048x1152",
    "output_format": "png",
    "watermark": false
  }
}
单张参考图编辑

将示例 image 地址替换为可访问的参考图 URL，也可以传 Base64 data URL。保持产品主体，修改背景。

请求体
{
  "model": "seedream-5.0-flash",
  "input": {
    "prompt": "Keep the product shape, material and color unchanged. Replace the background with pale limestone and soft morning window light.",
    "image": "https://example.com/product.png",
    "size": "1536x1024",
    "watermark": false
  }
}
生产环境回调

将 callback.url 替换为自己的 HTTPS 接收地址；任务结束后处理通知。水印默认关闭，也可以像本例一样显式传 false。

请求体
{
  "model": "seedream-5.0-flash",
  "input": {
    "prompt": "Studio product photograph of a matte teal ceramic teapot with a curved walnut handle, on pale limestone, soft morning window light, subtle steam, warm cream background, realistic material texture, no text.",
    "size": "2K",
    "watermark": false
  },
  "callback": {
    "url": "https://example.com/hiapi/callback",
    "when": "final"
  }
}

获取结果

  1. 提交任务并保存响应中的 data.taskId；提交成功不代表图片已生成。
  2. 生产环境等待 callback.url 收到终态通知；调试或补偿查询使用 GET /v1/tasks/:id，直到 data.status 为 success 或 fail。
  3. 成功后读取 data.output[].url；存储期限以返回的 expireAt 为准，需要长期使用时及时保存图片。
  4. 失败时根据错误信息修正请求；不要反复提交相同的无效参数。

常见问题

可以直接生成图片，也可以编辑吗？

不提供参考图时按文字生成；提供一张参考图时编辑原图，多张参考图时可以组合主体、场景或风格。两种用法共用同一个模型 ID，最多接受 10 张参考图。

如何控制画幅和分辨率？

size 支持 1K、1.5K、2K 或宽x高。需要精确画幅时填写像素尺寸；总像素须在 921600–4624220 之间，宽高比在 1:16–16:1 之间。当前不提供 4K 档。

透明背景需要什么输入？

仅在编辑一张带透明通道的参考图时使用 transparent。输出格式选择 PNG 或保持自动；它不是从任意白底图一键抠图的开关。

能一次生成多张或逐步返回吗？

当前每次任务生成一张图片，通过任务查询获取完整结果，不提供组图、流式图片或图层拆分输出。

怎样获取生成结果？

保存 taskId 后，生产环境通过 callback.url 接收终态通知，也可查询原任务。成功后从 output[].url 获取图片，按 expireAt 在过期前保存。

水印默认开启吗？

默认关闭，省略 watermark 或传 false 都不添加水印；需要时传 true。API 和 Playground 的默认设置一致。

下一步