使用ガイド
Ideogram v4.5 プロンプトレシピ:そのままコピー&ペーストできるタイポグラフィプロンプトと実際の出力
ほとんどの画像モデルは美しいポスターを描けますが、見出しのスペルを間違えます。Ideogram の評判はまさにその逆です:文字を正しく書けるのです。ideogram-v4.5/text-to-image は hiapi 上の最新の Ideogram テキスト・トゥ・イメージモデルで、他のすべてのモデルと同様に統一された task API 上で動作します。このページはそのまま使えるプロンプトライブラリです——ロゴ、ポスター、バナー、パッケージングをカバーする6つのレシピがあり、それぞれに私が実際に送信したプロンプトと、実際に返ってきた画像を添えています。以下のすべての出力は hiapi 上の ideogram-v4.5/text-to-image で生成されたものです。ストック素材は一枚もなく、レタッチされたものも一枚もありません。
また、これらのレシピが繰り返し引き起こす疑問にも答えます:quality ティアです。v4.5 は3つのティア——low、medium、high——で課金され、価格差が大きいので、同じプロンプトと同一シードを3ティアそれぞれで実行し、実際のテキストレンダリングを比較しました。結果は予想とは異なります。詳細は下記の品質ティアのセクションをご覧ください。
範囲:ここは基本的なテキスト・トゥ・イメージエンドポイントです。v4.5 には別途 image-to-image/編集ルート(
ideogram-v4.5/image-to-image)があり、マスクと参照画像をサポートします——それは別のスキーマであり、別記事で扱います。
v4.5 が実際に受け付けるスキーマ(想像より少ない)
レシピを見る前に、入力契約を説明します——v4.5 のインターフェース面は ideogram-v4 のものと同じではありません。私はオンライン API に対してフィールドごとに検証しました。必要なのはこの5つだけです:
| フィールド | 型 | 説明 |
|---|---|---|
prompt |
string、必須 | レンダリングしたいテキストを二重引用符で囲みます(次の節を参照)。 |
quality |
low / medium / high |
価格ティア。デフォルトの挙動は medium と同じです。 |
num_images |
整数 1–8 | 1つのタスクで画像一式を返せます。 |
seed |
整数 | 2つのプロンプト(または2つのティア)を公平に比較するために固定します。 |
image_size |
列挙型 | いずれか1つ:square_hd、square、portrait_4_3、portrait_16_9、landscape_4_3、landscape_16_9。 |
意外だったのは:aspect_ratio も resolution フィールドもありません。 v4 は aspect_ratio 文字列と rendering_speed を受け付けますが、v4.5 は両方とも削除しました。6つの image_size プリセットから1つの形状を選ぶことだけが可能で、これが唯一のサイズ制御です——API は aspect_ratio、resolution、rendering_speed、magic_prompt、style_type、negative_prompt を additional properties not allowed で直接拒否します。ですから v4 のリクエストから移行する場合は、これらのフィールドを削除してください。そうしないと毎回の呼び出しが 400 になります。
価格は hiapi オンライン料金ページに基づき、画像単位で課金され、ティアによって変わります:
quality |
画像1枚あたりの価格 |
|---|---|
low |
$0.043 |
medium |
$0.086 |
high |
$0.3145 |
以下は最小のリクエストです——タスクを作成し、完了するまでポーリングします:
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": "A clean wordmark logo, the text \"NORTHWIND ROASTERS\" in an elegant high-contrast serif, cream background, centered",
"quality": "medium",
"image_size": "square",
"num_images": 1
}
}'
# -> {"data":{"taskId":"tk-..."}}
import os, time, requests
BASE = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
task = requests.post(BASE, headers=H, json={
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": 'A clean wordmark logo, the text "NORTHWIND ROASTERS" '
'in an elegant high-contrast serif, cream background, centered',
"quality": "medium",
"image_size": "square",
"num_images": 1,
},
}).json()
tid = task["data"]["taskId"]
while True: # poll to a terminal state
d = requests.get(f"{BASE}/{tid}", headers=H).json()["data"]
if d["status"] in ("success", "fail"):
break
time.sleep(5)
print(d["output"][0]["url"]) # temp URL — download it right away
output[0].url は約1週間で失効する一時リンクなので、すぐにバイトをダウンロードしてください——本番環境へのホットリンクは避けてください。
すべてのレシピの成否を決める唯一のルール
以下のすべては1つの習慣の上に成り立っています:レンダリングしたい正確なテキストを二重引用符で囲み、あなたが気にするコピーをモデルに任せないこと。
Ideogram はプロンプトを拡張します。音楽フェスティバルのポスターを求めれば、あなたが書いていない出演者、日付、チケット価格を喜んで追加します——実際のモックアップを作る際には便利ですが、これらの詳細が正しくなければならない場合はリスクになります。テストでは、私が引用したすべての短い文字列は完璧に綴られました。モデル自身が捏造したテキストこそが誤字の発生源です。ですから:ブランド名、見出し、ボタンテキスト、日付には引用符を付けてください。装飾的な埋め草をモデルに任せてよいのは、モデルが何を言っても気にしない場合だけです。
このルールを踏まえて、以下がレシピです。
レシピ 1——ワードマークロゴ
A clean minimalist wordmark logo for a specialty coffee brand, the text "NORTHWIND ROASTERS" set in an elegant high-contrast serif, a small compass-rose icon integrated above the letter N, warm cream background, centered, flat vector-style design, generous negative space
image_size: square · quality: medium

「NORTHWIND ROASTERS」は完全に正しく、セリフ体は確かにエレガントで、ネガティブスペースは本物のブランドマークのように見えます。正直に2点述べます:モデルはコンパスローズを「文字 N の上」ではなくワードマーク全体の上部中央に配置しました——v4.5 は空間指示を座標ではなく提案として扱います——そして私が一切要求していないタグライン「SPECIALTY COFFEE · EST. 2019」を勝手に追加しました。この拡張は上記のルールが言及している挙動です:ここでは便利ですが、あなたの実際のタグラインが異なる場合は、モデルに推測させず、明示的に引用符で書いてください。
レシピ 2——イベントポスター
A vertical concert poster for an indie music festival, large headline text "ECHO VALLEY FEST" across the top, below it two lines reading "AUGUST 14-16" and "RIVERSIDE PARK", retro 1970s psychedelic palette of orange, magenta and teal, layered sunburst background, bold condensed type, high detail
image_size: portrait_4_3 · quality: medium

引用符で囲んだ3つの文字列——「ECHO VALLEY FEST」「AUGUST 14-16」「RIVERSIDE PARK」——はすべてクリーンにレンダリングされ、portrait_4_3 の形状がヘッドラインに余裕を与えています。モデルはさらに、もっともらしいバンドラインナップと「GATES 6PM · ALL AGES · $45 ADV / $60 DOOR」のフッターを自ら埋めました。提案用モックアップとしては贈り物ですが、実際のポスターとしては、これらの捏造された行をプロンプトに書き戻して制御できるようにしてください。
レシピ 3——ソーシャル広告バナー
A horizontal social media ad banner for a fitness app, left-aligned headline text "MOVE MORE." in heavy bold uppercase, a smaller line reading "Start your 7-day free trial", and a rounded call-to-action button with the text "GET THE APP", energetic gradient from lime green to deep blue, clean modern UI style
image_size: landscape_16_9 · quality: medium

これは v4.5 の最良のパフォーマンスです:3つの独立した短い文字列——見出し、サブタイトル、ボタンテキスト——がそれぞれ異なる UI ロールに配置され、すべて正しく綴られています。「MOVE MORE.」のピリオドまで含めて。landscape_16_9 プリセットは、ワイドなバナーやサムネイルが必要なときに使うべきものです。短く、明確で、引用符付きのコピーこそ、このモデルが得意とするものです。
レシピ 4——製品パッケージラベル
A product label for a bottle of artisanal hot sauce, brand name "EMBER & ASH" in a vintage woodcut serif, product line "SMOKED HABANERO" below it, a small badge reading "SMALL BATCH - 150ML", kraft-paper texture background with charcoal and ember-orange ink, symmetrical layout
image_size: square_hd · quality: medium

パッケージは最も難しいテキストテストです——小さい文字、特殊文字、バッジ——そして v4.5 は重要な部分をパスしました。「EMBER & ASH」は & 記号を正しくレンダリングし(古典的な失敗ポイント)、「SMOKED HABANERO」はクリーンで、木版画風のハバネロはプロンプトにない妙技です。小さなバッジは外れました:「SMALL BATCH - 150ML」を求めたのに、得られたのは「SMALL BATCH · EST · 150ML」に加えて「BOTTLED IN SMALL BATCHES」の一行でした。マニュアルの教訓は依然として有効です——文字が小さいほど、モデルは即興しやすくなるので、印刷するラベルでは極小コピーを短く保ち、レンダリングのたびに確認してください。
品質ティアの実測:low vs medium vs high
これらのレシピはすべて medium で実行されています。しかし v4.5 は low / medium / high に対してそれぞれ $0.043 / $0.086 / $0.3145 を課金します——最大7倍の差——なので、お金で何が買えるのかを知る価値があります。意図的にテキスト密度の高いプロンプト(密なインフォグラフィックポスター)を3つのティアで実行し、同じシードを使ったので、変化するのは quality だけです:
A dense informational poster titled "CITY TRANSIT GUIDE" with three labeled columns headed "BUS", "METRO" and "TRAM", a short line of body text under each heading, clean Swiss grid layout, red and black ink on off-white paper, flat vector infographic style
low — $0.043

レイアウトと「CITY TRANSIT GUIDE」の大見出しは明瞭です。しかしモデルはサブタイトルを捏造し、綴りを間違えました——「WINTER SCHHEDULE」に H が余分——さらに路線バッジを重複させました(「41」が2回)。引用符付きの見出し(BUS/METRO/TRAM)は問題ありません。モデルが追加した引用符なしのコピーこそが失敗箇所です。
medium — $0.086

同じシードで1ティア上げると、サブタイトルは「WINTER SCHEDULE」に自己修正されました。3つの本文段落は明瞭に読め、フッターナビ(「TICKETS · ZONES · DELAYS · HELP」)はクリーンです。小さなキャプションの不具合(「CENTRAL」ではなく「CENTRHL」)はまだありますが、これほどテキスト密度の高いレイアウトとしては、明らかに3つの中で最もクリーンです。
high — $0.3145

ここが直感に反する部分です。high がレンダリングするディスプレイ書体——大見出し、BUS/METRO/TRAM のラベル——は3つの中で最も鋭いです。しかし密な本文段落は自信に満ちた文字化けに崩壊します(「Mari routes runt monen downtwing...」「tith tixve stations across five...」)。価格が medium の3.6倍でありながら、このレイアウトでは本文がより悪くなり、良くはなりません。
結論は実用的で、モデルを貶めるものではありません:quality ティアは v4.5 が選んだ書体をレンダリングする精細度を高めますが、モデルがあなたの書いていない長いコピーを捏造するのが上手くなるわけではありません——high では、より精細に、そしてより誤って捏造するだけです。ですから:
mediumをデフォルトにする。 実際のテキストがあるものには最良のバランス点であり、lowが持ち込んだ誤字を修正します。highは残す——主に大きく、書体を指定した作品——ロゴ、一行見出しのポスター——にはその追加の鋭さが価値があり、幻覚を起こす段落もありません。lowはラフな草稿やサムネイルに適しており、個々の誤字が重要でない場合に。- どのティアでも、長い本文の綴りをモデルに頼らないこと。 必ず正しくなければならないテキストには引用符を付け、残りはプレースホルダーとして扱ってください。
FAQ
1080×1920 や正確なピクセルサイズを設定できますか? いいえ。v4.5 t2i は6つの image_size プリセット——square_hd、square、portrait_4_3、portrait_16_9、landscape_4_3、landscape_16_9——しか受け付けません。幅/高さや aspect_ratio フィールドはありません。最も近いプリセットを選び、正確な比率が必要ならクロップしてください。
これは ideogram-v4 とどう違いますか? 入力契約が異なります。v4 は aspect_ratio と rendering_speed(turbo/balanced/quality)を使用します;v4.5 はその両方を image_size プリセットと quality 価格ティアで置き換えました。v4 のリクエスト形状が必要なら、ideogram-v4 操作ガイドでカバーされており、タイポグラフィモデルをまだ選んでいるなら、ideogram-v4 vs Nano Banana 2 が役立ちます。
既存の画像を編集できますか? このエンドポイントではできません。テキスト・トゥ・イメージは ideogram-v4.5/text-to-image です;編集(プロンプト編集、マスク、参照画像)は別の ideogram-v4.5/image-to-image ルートです。
テキストは常に正しいですか? 短く引用符で囲んだ文字列——ブランド名、見出し、ボタンテキスト——は本文のすべてのレシピで信頼できます。モデル自身が捏造した長いコピーはそうではありません;毎回のレンダリングで校正してください。特に小さなバッジやキャプションに注意してください。
バリエーションを素早く生成するには? 1つのタスクで num_images を最大8に設定して一度に一式を返すか、seed を固定して1語を変え、同等条件でプロンプトを比較してください。
自分でこれらを実行する
上記のすべてのプロンプトはそのままコピー&ペーストできます——引用符付きの文字列をあなた自身のブランド、見出し、日付に置き換えて送信してください。ideogram-v4.5/text-to-image モデルページからライブスキーマを取得し、料金ページで quality ティアを選び、task API の初回呼び出しなら、クイックスタートがキーの取得と最初のタスクのポーリングを案内します。テキストに引用符を付け、デフォルトで medium を使い、公開前に毎回のレンダリングを校正してください。