
これはIdeogram 4.6 API用のプロンプト集で、コードにそのまま貼り付けられる完全なリクエストボディの形で書かれています。ideogram-v4.6によるテキストから画像が7つ、ideogram-v4.6-editによる編集が3つです。それぞれにサイズティアと料金を記載しているので、送信前に1回の実行コストがわかります。すべてのボディはIdeogram 4.6のPoYoスキーマに従い、POST https://api.poyo.ai/api/generate/submitに送信します。
プロンプト1は、2026年11月20日のローンチ当日のテストで使った実際のリクエストです。その他は実行していないテンプレートなので、出発点として扱い、すべての出力を確認してください。
Ideogram 4.6 APIプロンプトの書き方
スキーマでは最大10,000文字まで使えるので、具体的に書く余裕があります。タイポグラフィでうまく機能するプロンプトは、通常5つの要素で構成されます。
| 要素 | 例 |
|---|---|
| フォーマット | 「シルクスクリーン風のコンサートポスター」「フラットなベクターステッカー」「製品ラベル」 |
| 正確なテキスト(引用符付き、1行につき1文字列) | "NORTHBOUND JAZZ FESTIVAL" |
| 各行の階層と位置 | 「上部に大きく太い見出し」「イラストの下に小さな行」 |
| ビジュアルの内容と配色 | 「夕暮れの川の上のウッドベースとサックス、ティール、バーントオレンジ、クリーム」 |
| 仕上げ | 「細かな紙の質感、くっきりした文字、ゆったりした余白」 |
プロンプト拡張は常に有効なため、モデルがディテールを追加することがあります。テストのポスターでは、隅に小さな「EST. 1987」とWebアドレスが追加されました。Ideogram自身のガイダンスは「最終結果でスペルと配置を確認する」ことです。
設定は習慣ではなく段階に応じて選びましょう。レイアウトのドラフトにはvery_low(1.6 credits、$0.008)、デフォルトにはmedium(12 credits、$0.06)、最終版にはhighです。印刷サイズが必要でない限り、4,194,304ピクセル以下に収めてください。それを超えると、どの品質でも料金が2倍になります。
テキストから画像のプロンプト
1. 4Kのイベントポスター(テスト済み)
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
"size": "2304x3072",
"quality": "high",
"n": 1
}
}
ティア: 4K high、40 credits($0.20)。計測結果: タスクM4WA9OIQXVV80DHGは2304×3072のPNGを返し、小さなイタリック体の行を含む3行すべてが指定どおりに描画されました。ドラフトとして同じプロンプトを"quality": "very_low"と"size": "3:4"で送ると、768×1024の画像が1.6 credits($0.008)で返り、テキストは正しく、構図は異なっていました。
2. 1回のリクエストでレイアウトのドラフト
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Minimal bookstore event flyer with the headline \"AUTHOR NIGHT\" in large serif capitals, the line \"Thursday 7 PM · Upstairs\" below it, and a simple line drawing of an open book. Off-white paper, black and brick red.",
"size": "3:4",
"quality": "very_low",
"n": 8
}
}
ティア: 2K very_low、8 × 1.6 = 12.8 credits($0.064)。気に入ったレイアウトを選び、より大きなサイズのhighで再実行します。
3. 製品ラベル
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Front label for a small-batch hot sauce bottle, flat design, centered. Top line \"CASA FUEGO\" in a hand-painted script, middle line \"SMOKED HABANERO\" in bold sans-serif capitals, bottom line \"5 FL OZ · 148 ML\" in small type. Red, cream and charcoal, with a small chili illustration.",
"size": "1536x2048",
"quality": "medium"
}
}
ティア: 2K medium(3,145,728ピクセル)、12 credits($0.06)。
4. シード付きの透過ステッカー
{
"model": "ideogram-v4.6",
"input": {
"prompt": "A die-cut sticker of a cheerful cactus wearing sunglasses, with the words \"STAY SHARP\" on a curved banner underneath. Thick white outline, flat colors.",
"size": "1:1 HD",
"quality": "low",
"background": "transparent",
"seed": 42
}
}
ティア: 2K low、6 credits($0.03)。transparentはアルファチャンネル付きの画像を返します。結果を再現するには、同じseedとボディを使います。
5. 4:5のSNS用引用カード
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Instagram quote card. Large centered quote \"Ship small. Ship often.\" in a modern grotesk typeface, and below it a small line \"— The Release Notes Podcast\". Solid sage green background with a thin cream border.",
"size": "1024x1280",
"quality": "medium",
"n": 4
}
}
ティア: 2K medium、4 × 12 = 48 credits($0.24)。1024x1280は両辺が32の倍数である正確な4:5サイズです。
6. 16:9の動画サムネイル
{
"model": "ideogram-v4.6",
"input": {
"prompt": "YouTube thumbnail, bold and high contrast. Left half: the text \"I BUILT A TINY CABIN\" in thick white capitals with a black outline, stacked on three lines. Right half: a small wooden cabin in a snowy forest at blue hour, warm light in the windows.",
"size": "2560x1440",
"quality": "high"
}
}
ティア: 2K high(3,686,400ピクセル)、20 credits($0.10)。これより大きい正確な16:9サイズの4096x2304は40 creditsかかります。
7. 看板のある店頭シーン
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Photograph of a corner bakery at sunrise, wet cobblestones, a hand-painted wooden sign above the door reading \"MORNING CRUMB\", and a chalkboard by the door reading \"Fresh rye today\". Natural light, 35mm look.",
"size": "16:9",
"quality": "medium"
}
}
ティア: 2K medium、12 credits($0.06)。16:9プリセットは1024×576を返します。同じ料金ティアでより細かなディテールが欲しい場合は、2048x1152などのカスタムサイズを使ってください。
編集用プロンプト
編集では、image_urlsにちょうど1枚の画像を入れてideogram-v4.6-editを使います。Ideogramのページでは、文言の修正は別々のステップで行うことを勧めているので、1回の編集には1つの役割だけを持たせ、何を変えずに残すべきかを明記してください。
8. テキストを1行だけ変更し、他はすべて保持する
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
"image_urls": [
"https://example.com/northbound-poster.png"
],
"edit_precision": "high",
"context_window": "none",
"size": "auto",
"quality": "high",
"n": 1
}
}
ティア: ソースのサイズに従います。計測結果: 2304×3072のポスター(タスク672JRU198S22NS8D)では、出力は2304×3072のままで、変更されたピクセルはすべて日付の行を囲む1つのボックス内、画像の約1.1%に収まり、課金額は120 credits($0.60)でした。4,194,304ピクセル以下のソースなら44 credits($0.22)になります。
9. 製品をブランドカラーに再着色する
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Recolor the ceramic mug to the exact brand blue #1E6FD9. Keep the mug's shape, handle, shadows, the table and the background exactly the same.",
"image_urls": [
"https://example.com/mug.png"
],
"edit_precision": "high",
"quality": "medium"
}
}
ティア: medium編集、4,194,304ピクセルまでのソースで12 credits($0.06)、それを超えると40 creditsです。Ideogramは、高品質設定の「正確な色」タスクで使える結果の割合を、Ideogram 4.5の46%から83%に向上したと報告しています。
10. 参照画像をもとに素材を変更する
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change the toy car's body to brushed copper like the reference image. Keep the scene, lighting and camera angle the same.",
"image_urls": [
"https://example.com/toy-car.png"
],
"reference_image_urls": [
"https://example.com/copper-swatch.png"
],
"quality": "low",
"n": 2
}
}
ティア: lowの通常編集、4,194,304ピクセルまでの出力で2 × 6 = 12 credits($0.06)。通常の編集は画像を再生成するため、backgroundとカスタムsizeを指定できます。それ以外の部分をピクセル単位で正確に保つ必要がある場合は、edit_precision: highに切り替えてください。
プロンプトをテンプレート化する
ほとんどのアプリは固定のプロンプトを1つ送るのではなく、ユーザーのイベント名、製品、日付などでテンプレートを埋めます。引用符で囲む文字列は個別の変数として保持しましょう。そうすればリクエスト送信前に検証でき、後の編集(プロンプト8)で正確な文言を指定して対象にできます。テンプレートを安価で予測可能に保つためのルールをいくつか紹介します。
- ユーザーのテキスト内の引用符をエスケープする。 プロンプトはJSON文字列なので、紛れ込んだ
"がボディを壊します。文字列連結ではなく、JSONライブラリでボディを組み立ててください。 - テキストは短くする。 小さな画像上の長い文章は読みにくく、確認もしにくくなります。細かい文言は、独自のサイズ指定を付けて2行目に移しましょう。
- フォーマットごとにサイズを固定する。 出力の種類(ポスター、カード、サムネイル)ごとに1つのサイズを保存し、4,194,304ピクセルの境界と照合して、ユーザーに表示する料金と請求額を一致させます。
- タスクID、設定、
credits_amountを記録する。 結果に修正が必要なとき、何が生成したのかを推測せずに、同じボディを再実行したり、出力を編集に送ったりできます。 - ドラフトは
nで、仕上げは1枚で。very_lowのドラフトをまとめて作っても、highの2K画像1枚より安く、選んだレイアウトだけを最終レンダリングに進めます。
プロンプトをスケールする前のチェックリスト
| チェック項目 | 理由 |
|---|---|
| 画像内の文字列はすべて引用符で囲まれている | 正確なテキストに関するドキュメントのルール |
| カスタムサイズは32の倍数で、1辺256〜4096 | それ以外は拒否されます |
very_lowは4,194,304ピクセル以下でのみ使用 | それより大きいサイズでは拒否されます |
edit_precision: highとマスクではsize: autoを使用 | 他のサイズは拒否されます |
| 出力は3日以内にダウンロードする | 生成ファイルは期限切れになります |
Ideogram 4.6 APIガイドには、これらのボディをどれでも実行できるポーリングループがあり、テキストと精密編集のハウツーではプロンプト8〜10をさらに詳しく解説しています。
よくある質問
Ideogram 4.6 APIのプロンプトはどのくらいの長さにできますか? 1〜10,000文字で、空白以外の文字を少なくとも1文字含む必要があります。
Ideogram 4.6 APIの画像に正確なテキストを入れるには? プロンプト内で各行を引用符で囲み、配置場所を記述します。プロンプト拡張により小さな余分なディテールが追加されることがあるので、出力を確認してください。
1つのIdeogram 4.6 APIプロンプトから複数のバリエーションを得られますか?
はい。nを1〜8で設定します。各画像はティアの料金で課金されます。
Ideogram 4.6 APIの結果を再現するには?
同じボディを、同じseed(0〜2,147,483,647の整数)で送信します。
Ideogram 4.6 APIのドラフトにはどの品質を使うべきですか?
very_lowで、4,194,304ピクセルまでのサイズなら画像1枚あたり1.6 credits($0.008)です。テストのドラフトでは、768×1024でポスターのテキストが正しく描画されました。