Seedream 5.0 Lite API ガイド：テキスト生成画像と画像編集

内容の概要

• Seedream 5.0 Lite は ByteDance の画像モデルです。HiAPI では2つのエンドポイントがあり、seedream-5.0-lite/text-to-image と seedream-5.0-lite/image-to-image はいずれも画像1枚あたり $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）
価格	画像1枚あたり $0.035	画像1枚あたり $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。

中国語タイトル、英語サブタイトル、日付行のいずれも書いたとおりに描画されます。同じパターンはメニューボードや値札、パッケージにも使えます。テキストはおよそ6行以内に収めてください。価格がすべて正しいメニューを含む5つのパターンについてはSeedream 5.0 Lite プロンプトレシピをご覧ください。

画像生成画像：一箇所だけ変更し、残りは保つ

パターン：変更内容を一文で示し、その後に必ず変えてはいけないものをすべて列挙します。

部分的な色変更。元画像：

このマットな白い陶器のカップを、光沢のある反射を持つ深いコバルトブルーの釉薬カップに変える。湯気、オーク材のテーブル、開いたノート、万年筆、多肉植物、光、カメラアングルは完全に変えずに保つ。写真のようにリアルに

seedream-5.0-lite/image-to-image、参照画像1枚、3:2、2K、$0.035。

看板の文字の置き換え。

ドア上の木製看板の文字を「BAKERY CORNER」に置き換える。金色のセリフ体のスタイルと文字サイズは同じに保つ。看板の形と木目の質感、レンガ壁のファサード、光る窓、オリーブの木、曇天の光は完全に変えずに保つ。写真のようにリアルに

seedream-5.0-lite/image-to-image、参照画像1枚、3:2、2K、$0.035。

2枚の画像の合成。image_urls 内の画像の順番で参照します：

1枚目の画像のレザーバックパックを取り出し、2枚目の画像のキャンプシーンにある平らな花崗岩の巨石の上に置く。わずかに角度をつけて自然にもたれかかるようにし、暖かいゴールデンアワーの日差しに合わせてライティングをやり直し、岩の上に柔らかな影を落とす。石積みのファイヤーリング、松林、山頂は変えずに保つ。写真のようにリアルな合成

seedream-5.0-lite/image-to-image、参照画像2枚、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 のどれを選ぶか

モデル	画像1枚あたりの価格	適した用途
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）	最終アセットに最高のディテールが必要な場合

より安価な2つのモデルを同一プロンプトで比較したテストはSeedream 5.0 Flash と Lite の比較をご覧ください。完全な価格はSeedream 5.0 API の料金にあります。

よくある質問

参照画像1枚ごとに追加料金がかかりますか？

いいえ。画像生成画像は出力1枚あたり $0.035 で、参照画像を1枚送っても14枚送っても変わりません。

中国語の文字も描画できますか？

はい。上記のポスターは同じ1枚の画像に中国語タイトルと英語サブタイトルの両方を含んでいます。各文字列を引用符で囲み、位置を指定するだけです。

製品を完全に同じに保てますか？

指定した内容は保持されます。保つ必要がある要素（形状、ラベル、光、カメラアングル）をすべて列挙してください。言及しなかったものは変化する可能性があります。

2K と 4K のどちらを選ぶべきですか？

価格は同じです。2K は長辺約 2,300 px、4K は約 4,096 px です。2K はファイルが小さく、反復作業中の確認が容易です。印刷が必要なときは 4K に切り替えてください。