はじめに
image_url に元画像を渡し、変更内容を説明します。黒地に白のマスクで編集領域を示し、参照画像でスタイルや内容を伝え、高い編集精度で変更の範囲を抑えられます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| 公開ブランド | 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 文字以内 |
image_url | はい | 変更する画像をこのフィールドで渡します。元画像に別途料金はかかりません。 1 文字以上 |
mask_url | いいえ | 白黒のマスクを任意で渡せます。白い部分が変更箇所です。 1 文字以上 |
reference_image_urls | いいえ | 内容やスタイルの参照画像を最大 4 枚、マスク付きなら最大 3 枚添付し、Image 1 以降の番号で指定します。参照画像数は請求額に影響しません。 4 件以内 |
aspect_ratio | いいえ | 編集後のキャンバスを 1:1、4:3、3:4、3:2、2:3、16:9、9:16 に設定します。7 種類とも選択した品質の単価で利用できます。 |
quality | いいえ | 編集では |
resolution | いいえ | 編集結果は 1k または 2k で出力でき、サイズによる値上がりはありません。 |
edit_precision | いいえ | regular または high を選びます。high は変更をより控えめにします。 |
料金
編集料金は品質で決まり、低価格の very_low も選べます。画像サイズ、比率、参照画像数による加算はなく、失敗した編集への請求はありません。
| 仕様 | 料金 |
|---|---|
| $0.0096 / 枚 |
| $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 image-to-image は image_url の画像に prompt の変更を加えます。既存の場面への追加、細部の修正、デザインへの視覚的なガイドに向きます。変える部分と残す要素を明記して両方を明確にします。
温室のテストは、石の通路に木のベンチと眠るオレンジ色の猫を加え、周囲の植物と光を保ちました。別のテストでマスク、参照、high の編集精度が機能しました。操作の根拠ですが、全リクエストの完全な保持は示しません。
編集のパラメータ
| パラメータ | 値・上限 | 役割 |
|---|---|---|
image_url | 元画像 | 変更する対象を指定します。 |
| prompt | 最大 10,000 文字 | 変更、保持、引用文字を示します。 |
mask_url | 任意の白黒マスク | 白が変更する領域です。 |
reference_image_urls | 最大 4 枚、マスクありなら 3 枚 | Image 1 以降の視覚スタイルや内容を供給します。 |
edit_precision | regular, high | high はより控えめな変更です。 |
| quality | very_low, low, medium, high、既定 medium | 画像単価を決めます。 |
| resolution | 1k, 2k | 出力サイズを選びます。 |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | 編集後の形を設定します。 |
quality は料金段階、edit_precision は変更の控えめさという別の役割です。high の精度と high の品質は同じ指示ではありません。
元画像を中心に説明する
変更と保持を分ける
ベンチを加える、ラベルを塗り替えるなど直接の動作で始め、植物、机、光、物の形など残す細部を続けます。漠然と改善とだけ書いて重要部分を推測させないでください。
温室ならベンチの場所と眠る猫を示して周囲を保ちます。文字を加えるなら正確な文言と位置を指定し、新しい文字と残す既存文字を両方確認します。
マスクで領域を指定
任意の白黒マスクの白が編集対象です。内部で何を変え、周囲に何を残すかを記述します。マスクの効果は確認しましたが、毎回すべての境界や周辺が同一になる測定ではありません。
mask_url を加えると参照数を再確認します。なしなら 4 枚、ありなら 3 枚です。これは参照一覧の制限で、編集対象は引き続き image_url です。
参照に別々の役目を与える
元画像は修正対象を定め、参照は見た目や内容を供給します。Image 1、Image 2 以降と呼び、各貢献を説明します。植物の色の参照なら、商品の形を置き換えずラベルを導けます。
複数参照なら素材と色などを短く対応付け、最後に元から残す細部を書きます。テストは参照が機能したことを示し、全参照の全細部の転写を証明してはいません。
続ける前に結果を確認
追加物、保持場面、文字、画面を元と比べます。温室はベンチと猫の周囲の植物や光を保ちました。単一変更の例として使い、長い連続編集の保証に広げないでください。
複数回を予定するなら採用版を残し、次の指示を具体化します。次の段階の入力にする前に毎回確認します。人物は使用権のある成人の写真を用い、なりすましをしません。
料金を決める要素
編集は品質に応じた画像単価で、very_low は低価格の編集段階です。高品質ほど単価が上がります。サイズ、比率、参照数では変わらず、編集精度の追加単価もありません。編集が失敗したときの請求はありません。
Ideogram 4.5 のモデルページ で現行価格を確認します。用途で 1k、2k と形を決め、予算で品質を選びます。マスクや追加参照はガイドで、別の課金単位ではありません。
制限と関連ツール
Ideogram の独自フィルターで検出した依頼は無料で拒否されます。採用した出力は削除される 14 日以内に保存します。
文章から新規画像なら text-to-image、写真の切り抜きなら Ideogram Remove Background、SVG 納品なら Ideogram Vector 1 に進みます。編集指示でファイル形式が変わると考えず、入力と出力に合う処理を選んでください。
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/edit",
"input": {
"edit_precision": "regular",
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k"
}
}'
# 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 リファレンスを参照してください。







