使用ガイド
hiapi API で seedream-4.5/text-to-image を使ってEC商品画像を生成する
すべての商品画像が写真から始まるわけではありません。サンプルが存在する前、カメラマンを手配する前、あるいは季節セールのバナーを明朝までに用意しなければならないとき、必要なのは短い文章の記述だけで画像を生成することです——クリーンな商品レンダリング、ライフスタイルシーン、正確で読みやすい見出し文字入りのプロモーション画像を。
seedream-4.5/text-to-image はまさにこうしたゼロショットのシナリオ向けに作られています。平易な言葉で書かれた記述を渡すと、参照写真を一切必要とせずに写真のようにリアルな画像を返します——しかも画像内の正確な文字まで含まれます。これは多くのテキストto画像モデルが今なお間違える部分です。hiapi 上では、他のすべてのモデルと同じ非同期 /v1/tasks エンドポイントで動作し、価格は1枚あたり $0.045、解像度は 2K または 4K です。
以下の2つの例はどちらも実際の API 呼び出しで、それぞれの正確なプロンプトと生成された画像を示しています——後処理は一切ありません。
ゼロショット生成と実際の写真編集の比較
seedream-4.5 は異なる役割を担う2つのモデルとしてリリースされています：
seedream-4.5/text-to-image（本記事のテーマ）は写真の入力なしに記述から画像を生成します。製品にまだクリーンな参照写真がないとき、カタログに存在しないシーンやコンセプトが必要なとき、あるいは成果物が特定の実物製品の写真ではなくマーケティング用アートであるときに使います。seedream-4.5/image-to-imageは手持ちの実物製品写真を編集し、その正確な形状とブランドアイデンティティを保ちながら背景や状況を変更します——このワークフローについては画像to画像ECガイドを参照してください。
特定の実物 SKU とピクセル単位で一致させる必要がある場合は編集モデルを使ってください。まったく新しいもの——コンセプトレンダリング、季節バナー、まだ存在しないシーン——を生成するなら、テキストto画像が適切なツールであり、本記事で扱う内容です。
例1：テキストから生成したスタジオ商品画像
モデルに送信したプロンプト：
a minimalist amber glass skincare serum bottle with a brushed silver cap
standing on a polished travertine surface, soft diffused window light
casting a gentle gradient shadow, sage green linen backdrop, one small
dried eucalyptus sprig beside the bottle, e-commerce product photography,
sharp focus, clean composition, no text, no logo, subtle reflection on
the stone surface
リクエストパラメータ：aspect_ratio: "1:1"、resolution: "2K"。
ここには瓶もスタジオもカメラマンもいません——影の減衰、石面の反射、柔らかな窓光はすべて記述から生まれています。这正是文本生图相对于编辑的优势所在：为一个仍在开发中的产品生成商品列表效果图或情绪板，大约一分钟即可完成，而不用排期拍摄。
例2：正確で読みやすい見出し文字入りのプロモーション画像
文字レンダリングはこのモデルのタスクの中でも難しい半分です——多くの画像生成器は文字化けやスペルミスのある文字を生成します。2つのプロンプトはいずれも再試行なしです：
フラットレイのプロモーションバナー：
a flat-lay e-commerce marketing banner for a summer skincare sale, an
arrangement of amber glass bottles and dried botanicals on a warm
terracotta background, bold sans-serif headline text 'SUMMER GLOW SALE'
near the top in cream white lettering, smaller text 'Up to 30% Off'
beneath it in matching cream, clean modern layout with generous negative
space on the right third, professional marketing design, crisp legible
typography, warm cinematic lighting
リクエストパラメータ：aspect_ratio: "4:3"、resolution: "2K"。
縦型ストーリー画像：
a vertical social media story graphic for a candle brand product launch,
a single black matte ceramic candle jar centered on a deep charcoal
gradient background, bold white headline text 'NEW ARRIVAL' near the
top, smaller subtext 'Shop the Collection' below the product, minimalist
premium aesthetic, soft rim lighting on the candle jar, generous margin
for mobile screen safe zones
リクエストパラメータ：aspect_ratio: "9:16"、resolution: "2K"。
2つの見出しと2つのサブテキストはすべて正しく綴られ、字間も均一で、プロンプトで指定した位置に正確に配置されています——初回生成でこうなっており、再試行は不要でした。この信頼性こそが、納期の厳しいプロモーション素材にテキストto画像を使える理由です：本来デザイナーが作るプロモーションバナーやストーリー画像を、今では1回の API 呼び出しで下書きできるのです。
API を直接呼び出す
seedream-4.5/text-to-image は hiapi の非同期タスクエンドポイントで動作します：タスクを送信し、完了するまでポーリングし、結果をダウンロードします。
curl：
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-4.5/text-to-image",
"input": {
"prompt": "a minimalist amber glass skincare serum bottle on a travertine surface, soft window light, sage linen backdrop, e-commerce product photography, no text",
"aspect_ratio": "1:1",
"resolution": "2K"
}
}'
レスポンスは task_id を返します。status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、output[0].url から画像を取得します。この URL には時間制限があります——すぐにダウンロードしてください。
Python（タスク送信 + ポーリング + ダウンロード）：
import os
import time
import requests
API_BASE = "https://api.hiapi.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}
def generate_product_image(prompt: str, aspect_ratio: str = "1:1",
resolution: str = "2K") -> bytes:
resp = requests.post(
f"{API_BASE}/tasks",
headers=HEADERS,
json={
"model": "seedream-4.5/text-to-image",
"input": {
"prompt": prompt,
"aspect_ratio": aspect_ratio,
"resolution": resolution,
},
},
timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["task_id"]
while True:
poll = requests.get(f"{API_BASE}/tasks/{task_id}", headers=HEADERS, timeout=30)
poll.raise_for_status()
data = poll.json()
if data["status"] == "succeeded":
image_url = data["output"][0]["url"]
return requests.get(image_url, timeout=30).content
if data["status"] == "failed":
raise RuntimeError(f"task {task_id} failed: {data.get('error')}")
time.sleep(3)
製品ラインを一括生成する
同じ呼び出しは製品ライン全体に展開できます：(name, prompt, aspect_ratio) タプルのリストを用意し、各項目に対して1つのタスクを実行し、名前を付けてディスクに保存します。
JOBS = [
{
"name": "serum-hero",
"prompt": "a minimalist amber glass skincare serum bottle on a travertine "
"surface, soft window light, sage linen backdrop, e-commerce "
"product photography, no text",
"aspect_ratio": "1:1",
},
{
"name": "sale-banner",
"prompt": "a flat-lay e-commerce marketing banner for a summer skincare "
"sale, amber glass bottles on a terracotta background, bold "
"headline text 'SUMMER GLOW SALE', smaller text 'Up to 30% Off'",
"aspect_ratio": "4:3",
},
{
"name": "story-launch",
"prompt": "a vertical social story graphic, a black matte ceramic candle "
"jar on a charcoal gradient background, bold white headline "
"'NEW ARRIVAL', subtext 'Shop the Collection'",
"aspect_ratio": "9:16",
},
]
for job in JOBS:
image_bytes = generate_product_image(
prompt=job["prompt"],
aspect_ratio=job["aspect_ratio"],
resolution="2K",
)
with open(f"{job['name']}.jpg", "wb") as f:
f.write(image_bytes)
print(f"{job['name']}: done")
1枚あたり $0.045 で計算すると、20素材の季節キャンペーン——ヒーロー画像、バナー、ストーリー画像を合わせて——のコストは約 $0.90 です。各タスクは独立しているため、複数の /v1/tasks 呼び出しを同時に送信して並行してポーリングする（アカウントのレート制限を守ってください）方が、リストを順番に実行するより高速です。
seedream-5.0-pro との比較
hiapi では seedream-5.0-pro も、EC向けテキストto画像作業のための独立した、より新しいティアとして提供されています。両者は同じモデルではなく、価格、解像度オプション、出力特性が異なり、seedream-5.0-pro のワークフローは専用ガイドで紹介されています。成果物に信頼できる画像内文字——プロモーションバナー、ストーリー画像、セールカード——が必要で、価格を1枚あたり $0.045 の固定にし、解像度別の段階価格を考慮した計画を立てたくない場合、seedream-4.5/text-to-image こそ選ぶべきモデルです。
よくある質問
seedream-4.5/text-to-image は参照写真を受け付けますか？
いいえ——text-to-image は prompt、aspect_ratio、resolution のみを受け付けます。新しい画像を生成するのではなく既存の製品写真を編集するには、seedream-4.5/image-to-image を使用してください。
対応している解像度とアスペクト比は？
resolution は 2K または 4K のみを受け付けます——1K ティアはありません。aspect_ratio は 1:1、4:3、3:4、16:9、9:16、2:3、3:2、21:9 を受け付けます。
見出し文字を画像内に確実にレンダリングできますか？ はい——上記2つのプロモーション例はいずれも、初回生成で複数単語の見出しとサブテキストを正しくレンダリングし、スペルミスも文字化けもありませんでした。
製品ラインを一括生成するコストはいくらですか？ 解像度ティアに関係なく、1枚あたり $0.045 です。20枚の季節セットは約 $0.90、100枚のセットは約 $4.50 です。
バッチ処理を高速化するために生成を並行実行できますか？
はい——各タスクは独立しているため、複数の /v1/tasks 呼び出しを同時に送信して並行してポーリングするのが、大量の素材を生み出す最速の方法です。
ぜひ試してみてください
完全なパラメータリファレンスとリアルタイム価格についてはモデルページと価格ページを参照してください。このモデルのさらなるプロンプトパターンについては、seedream-4.5 テキストto画像プロンプトレシピを参照してください。ワークフローが空白のページではなく実際の製品写真から始まる場合、seedream-4.5 画像to画像ECガイドがそれを直接編集する方法を扱っています。
API キーを取得して、最初の製品画像やプロモーションバナーを生成しましょう——上記のコードは今日そのままコピー＆ペーストして、hiapi API に対して直接実行できます。
