はじめに
デザインに入れる言葉を引用符で囲み、構図を prompt で送ります。品質は画像サイズや比率とは別に選びます。プロンプト拡張では短い指示を補足できます。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| 公開ブランド | Ideogram |
| 対応タスク | text-to-image による画像作成と image-to-image による修正に対応します。 |
| 文章の許容量 | 最大 10,000 文字で、表示する文字を引用します。 |
| 生成時の品質 | low、medium(既定)、high です。 |
| 編集時の品質 |
|
| 出力解像度 | 1k または 2k で、サイズを変えても品質段階の単価は同じです。 |
| 画面比率 | 1:1、4:3、3:4、3:2、2:3、16:9、9:16 |
| 編集のガイド | 任意の白黒マスクで、白が変更部分です。 |
| 参照画像の上限 | スタイルや内容の画像を最大 4 枚、マスク併用では 3 枚です。 |
| 変更の精度 | regular または high で、high は控えめな変更です。 |
| 価格の決まり方 | 品質に応じた画像単価で、サイズ、比率、参照数は変えません。失敗は無料です。 |
| 結果の保管 | 14 日が経過すると、生成されたファイルの削除が行われます。 |
主な機能とハイライト
補助行も保った AFTER DARK
新しいポスターは光沢のある赤い題名と、サテンのガウンの女性の下の One night only を組み合わせました。medium、1k、2:3 で両文字列は正確でした。引用行ごとに場所を決め、人物、ネオン、印刷の質感を周りに書く階層の参考になります。2 つの指定文字ブロックの実測例なので、自分の出力も校正してください。
目的地の名前の下に祭りの詳細
LUMEN BAY は大きな目的地名と小さな Summer Festival · July 12–14 を合わせ、帆船と縞の灯台の海辺で両方が明瞭でした。イラストを説明する前に、見出しとイベント情報に別の位置を与えます。料金段階は品質で決まり、1k と 2k はその段階で同額です。
温室の猫の居場所を追加
温室の通路に木のベンチと眠るオレンジ色の猫を加え、周囲の植物と光は変わりませんでした。追加物を指定し、残りの場面を保持目標にします。領域を限定するなら白で示す任意マスクを使えます。参照と high の編集精度も機能しましたが、毎回目視確認は必要です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 画像を 10,000 文字以内で説明し、表示したい文字を引用符で囲みます。プロンプトの長さで価格は決まりません。 1 文字以上 · 10000 文字以内 |
aspect_ratio | いいえ | 1:1、4:3、3:4、3:2、2:3、16:9、9:16 から構図を選べます。比率による追加料金はありません。 |
quality | いいえ | 生成では low、medium(既定)、high を選べます。品質の段階が上がるほど、画像 1 枚の料金が高くなります。 |
resolution | いいえ | 画像サイズを 1k または 2k に設定します。品質の段階に応じた料金は変わりません。 |
enable_prompt_expansion | いいえ | 有効にすると、生成前にモデルが短い指示を拡張します。料金の基準は引き続き品質です。 デフォルト値: |
料金
生成画像ごとに、選んだ品質の単価で課金されます。解像度や比率で単価は変わらず、リクエストが失敗した場合は課金されません。
| 仕様 | 料金 |
|---|---|
| $0.036 / 枚 |
| $0.072 / 枚 |
| $0.264 / 枚 |
ユースケース
レトロ映画と夜のイベントのポスター
引用した見出しと独立したイベント行を中心に構成します。AFTER DARK の medium、1k、2:3 では両行が正確で、サテンのガウンの人物とレトロな表現が得られました。
旅行と祭りのアート
目的地の名前をイラストの上、イベント詳細を下に置きます。LUMEN BAY では海辺の絵とともに、大きな題名と小さな祭りの文字が明瞭でした。
既存場面への小さな追加
周囲と光を残す指示で特定の物を加えます。温室では木のベンチと眠るオレンジ色の猫を追加し、ほかの場面は変わりませんでした。
参照で導くデザイン修正
色、素材、スタイル、内容の画像を渡し、それぞれの役割を説明します。編集の参照は最大 4 枚、マスクを併用すると 3 枚です。
構図内の限定領域を変える
白黒マスクの白で箇所を示し、その領域の変更を文章にします。high の編集精度はより控えめな変更に使え、マスクとこの精度がテストで機能しました。
プロンプトガイドと実践のヒント
新規画像か編集かを決めます
文章で構図を作るなら text-to-image、既存画像の場面を使うなら image-to-image を選び、
image_urlに渡します。文言と画面演出を分けます
題名と補助行を各々引用し、置く場所を書きます。その周りの場所、服装、光、グラフィックの質感も説明します。
品質とキャンバスを選択
画像単価を決める品質を選び、別に 1k、2k と対応比率を設定します。既定品質は medium で、編集は
very_lowも使えます。変更を導いて確認
編集は任意の白い領域のマスクを加え、参照に番号と役割を与えます。文字と保持した細部を確認し、採用ファイルを保存期間の 14 日以内に取得します。
言葉から構図を作る
Ideogram 4.5 text-to-image は場面説明から始め、指定文字を画像内に配置できます。文章の説明から新しいポスター、イラスト表紙、イベント画像を作る際に使います。引用文が描く言葉、アートの指示がその周囲を説明します。
2 つの実測ポスターが基準です。LUMEN BAY は明瞭な目的地名と小さな祭りの行、AFTER DARK は光沢のある赤い見出しと One night only、サテンのガウンの女性のレトロ構図を示しました。個別の配置で、どんな句や構成への約束でもありません。
パラメータと役割
| パラメータ | 選択肢・上限 | 使い方 |
|---|---|---|
| prompt | 最大 10,000 文字 | 構図を説明し、必要な文字を引用します。 |
| quality | low, medium, high、既定 medium | 画像単価の段階を決めます。 |
| resolution | 1k, 2k | 単価を変えずサイズを選びます。 |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | 配置先に合う形を設定します。 |
enable_prompt_expansion | 任意のプロンプト拡張 | 生成前に短い説明を詳しくします。 |
生成に編集用の very_low はありません。元画像が必要なら image-to-image で、マスク、視覚参照、編集精度も使えます。
品質別の価格
納品画像の料金は品質によります。low から medium、high へ上げると高くなりますが、1k と 2k では変わりません。7 比率も同じ品質単価です。文章の長さは許容量であり課金単位ではありません。
段階を選ぶ前に Ideogram 4.5 のモデルページ の最新価格を確認します。失敗は無料です。品質は単価、キャンバスはサイズと形を決める別の判断です。
文字をレイアウトの一部に
文字ブロックに役割を与える
装飾より先に文言を決めます。見出し、補助行、位置、その周りの場面という順が使えます。AFTER DARK の型なら引用した題名を人物の上、短いイベント行を下の余白に置きます。
重要な句読点も含め、文字列全体を引用符内に書きます。主役の行と小さい行を決め、同じ重みの言葉の集まりでなく階層を与えます。使用前に見出しと補助行を原稿と照合します。
具体的に場面を演出
人物なら被写体、服装、場所、雰囲気、光を書きます。ネオンの映画館の外のサテンのイブニングガウンの 30 代後半の女性と、駅の開襟シャツの 40 代男性では違う場面です。提案シーンの人物は 30 代以上にします。
レトロポスターのスクリーンプリントの質感や限定色など、目的に合う表現を選びます。文字位置の説明とともに設定でも比率を決めます。縦は 2:3、横の配置は対応する横比率を使えます。
短い説明を拡張
enable_prompt_expansion は画像化前に短い指示を詳しくします。テストで効果を確認しました。意図する文言は直接決められるデザイン要素なので、拡張する場合も題名とイベント文は自分で書きます。
検証した結果
- LUMEN BAY は題名と Summer Festival · July 12–14 が明瞭でした。
- medium、1k、2:3 の AFTER DARK は見出しと One night only が正しく、サテンのガウンの人物が振り返りました。
- プロンプト拡張が機能しましたが、すべての指示で改善する根拠ではありません。
小さい文字も見出しと同じく確認します。掲載配置の根拠で、無関係なデザインや長文の成功率は測定していません。
制限と次の処理
Ideogram 側の審査でブロックされた内容は拒否され、課金しません。生成ファイルは 14 日後に削除するため、採用画像と prompt、設定を保存します。
既存画像で場面を決める変更はこのモデルの image-to-image を選びます。SVG は Ideogram Vector 1、写真の背景除去は Ideogram Remove Background です。新規ポスターとは入力素材と出力が異なります。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/4.5/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。






