Seedream 5.0 Lite API 指南：文生图与图像编辑

内容摘要

• Seedream 5.0 Lite 是字节跳动的图像模型。在 HiAPI 上它有两个端点：seedream-5.0-lite/text-to-image 和 seedream-5.0-lite/image-to-image，两者均为每张图片 $0.035，2K 或 4K 同价。
• 它擅长在图像中精准呈现文字，也擅长定向编辑：改动单个对象、替换招牌上的文字，或最多合成 14 张参考图，同时让场景其余部分保持不动。
• 每次调用都必须提供 aspect_ratio 和 resolution。打开文生图模型页面即可试用；新账户赠送 200 个免费额度。

文生图还是图生图

	文生图	图生图
模型 ID	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
必填项	prompt、aspect_ratio、resolution	同上，另加 image_urls（1–14）
价格	每张图片 $0.035	每张图片 $0.035，不论多少张参考图
适用场景	海报、菜单、包装、信息图	改色、文字替换、产品入景合成

HiAPI 实时价格，核实于 2026 年 10 月 19 日。失败的任务不收费。

4K 与 2K 同价，所以需要印刷尺寸时直接请求 4K。$1 约可生成 28 张图片。

文生图：文字准确呈现

把每个希望渲染的词放进引号，并为每个字符串指定位置：

一张手绘丝网印刷风格的海报，主题是虚构的夜市美食节，顶部是大号中文书法标题“夜市食堂”，其正下方是英文副标题“NIGHT MARKET CANTEEN”，使用窄体无衬线字体，底部是日期行“OCT 17-19 · RIVERSIDE PIER”，暖色灯笼光晕笼罩着拥挤的小吃摊，竹蒸笼里升起蒸汽，限定配色为朱红、奶油色和墨蓝，可见印刷颗粒感，复古海报构图

生成这张海报 →

seedream-5.0-lite/text-to-image，2K，$0.035。

中文标题、英文副标题和日期行都按所写内容呈现。同样的模式适用于菜单板、价签和包装；文字控制在约六行以内。更多五种模式（包括每个价格都正确的菜单）见Seedream 5.0 Lite 提示词配方。

图生图：只改一处，其余保留

模式：一句话说明改动，然后点名所有必须保持不变的内容。

局部改色。原图：

把这只哑光白色陶瓷杯改成深钴蓝色釉面杯，带光泽反光质感，保持热气、橡木桌、打开的笔记本、钢笔、多肉植物、光线和相机角度完全不变，照片级写实

seedream-5.0-lite/image-to-image，一张参考图，3:2，2K，$0.035。

招牌文字替换。

把门上木制招牌的文字替换为“BAKERY CORNER”，保持相同的金色衬线字体风格和字号，保持招牌形状和木质纹理、砖墙立面、发光的窗户、橄榄树和阴天光线完全不变，照片级写实

seedream-5.0-lite/image-to-image，一张参考图，3:2，2K，$0.035。

双图合成。按图片在 image_urls 中的顺序引用：

取第一张图中的皮革背包，把它放在第二张图营地场景中的扁平花岗岩巨石上，以轻微角度自然倚靠，重新打光以匹配温暖的金色时分阳光，并在岩石上投下柔和阴影，保持石砌火圈、松林和山峰不变，照片级写实合成

seedream-5.0-lite/image-to-image，两张参考图，3:2，2K，$0.035。

将 aspect_ratio 设置为与输入一致。若请求不同的画幅形状，部分编辑效果会被重新裁剪消耗掉。

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

你会收到一个 taskId。轮询 GET https://api.hiapi.ai/v1/tasks/{taskId}，直到 data.status 为 success，然后下载 data.output[0].url。链接会过期，请立即保存文件。

若要进行编辑，将模型改为 seedream-5.0-lite/image-to-image 并添加 "image_urls": ["https://your-cdn.example.com/input.jpg"]。

Python：先生成，再编辑

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

如果之后还要复用结果，请在每个结果就绪后立即下载；输出链接会过期。

参数

字段	必填	取值	说明
prompt	是	4–3,000 个字符	把需要渲染的文字放进引号
aspect_ratio	是	1:1、4:3、3:4、16:9、9:16、2:3、3:2、21:9	编辑时与输入保持一致
resolution	是	2K、4K	大写；价格相同
image_urls	仅图生图	1–14 个 URL	jpeg、png 或 webp，每张最大 10 MB

没有 seed、negative_prompt 或 output_format。

常见错误

以下错误都在提交时返回 HTTP 400，因此不会创建任务，也不会产生费用：

• aspect_ratio: missing required field / resolution: missing required field：两者都是必填，尽管文档列出了默认值。
• resolution: value must be one of '2K', '4K'：没有 1K。请使用大写。
• image_urls: maxItems: got 15, want 14：最多 14 张参考图。
• prompt: minLength: got 2, want 4：提示词至少需要 4 个字符。
• additional properties 'output_format' not allowed：Lite 上没有该字段。

Lite、Flash 还是 Pro？

模型	每张图片价格	适用场景
Seedream 5.0 Flash	$0.025	最看重批量与速度
Seedream 5.0 Lite	2K 或 4K 均为 $0.035	图像文字、精细编辑、4K 无额外费用
Seedream 5.0 Pro	$0.05（1K）/ $0.10（2K）	最终资产需要最高细节

两个更便宜档位的同提示词对比测试见Seedream 5.0 Flash 与 Lite 对比。完整价格见Seedream 5.0 API 定价。

常见问题

每张参考图会额外收费吗？

不会。图生图每张输出 $0.035，无论发送 1 张还是 14 张参考图。

能渲染中文文字吗？

可以。上面的海报在同一张图中同时包含中文标题和英文副标题。给每个字符串加引号并锚定位置即可。

会让我的产品完全保持一致吗？

它会保留你点名的内容。请列出所有必须保持的元素（形状、标签、光线、相机角度）；任何未提及的内容都可能变化。

选 2K 还是 4K？

价格相同。2K 长边约 2,300 px，4K 约 4,096 px。2K 文件更小，迭代时更便于查看；需要印刷时切换到 4K。