
Ideogram 4.6 APIを使うと、Ideogramの最新画像モデルをPoYoの1つのRESTエンドポイントから呼び出せます。テキストから画像を生成するにはideogram-v4.6、1枚のソース画像を編集するにはideogram-v4.6-editを使い、編集ではマスクと参照画像を任意で指定できます。出力は1辺最大4096ピクセルで、料金は1枚あたり1.6 credits($0.008)から。すべてのリクエストはPoYoの他のモデルと同じAPIキーを使います。このページでは、Ideogram 4.6とは何か、正確な上限、料金ティア、そしてローンチ当日に計測した結果をまとめます。
Ideogram 4.6とは?
Ideogram 4.6は、Ideogramが2026年11月19日にリリースした画像生成・編集モデルです。Ideogramはこれを「これまでで最も精密な編集モデル」と呼び、「ネイティブ4Kで画像を生成する」「アップスケーリングなし」と説明しています。モデルページでは、このモデルが「編集範囲の外側のピクセルのずれがはるかに少なく、色をより正確に保持する」とも述べています。
Ideogramはこれを高品質設定でのタスク別スコアで裏付け、4.6と4.5を比較しています。
| タスク(Ideogramによる説明) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| 正確な色:オブジェクトをブランドのHEXコードに再着色 | 83% | 46% |
| 製品のディテール:製品写真の小さな欠陥を修復 | 86% | 61% |
| 製品ショット:製品の配置、スタイル変更、ラベル変更 | 88% | 66% |
| キャラクターの一貫性:新しいシーンでも人物を識別可能に保つ | 85% | 69% |
| マスク編集:塗った領域だけを変更 | 90% | 82% |
これらはIdeogramの数値であり、PoYoの計測値ではありません。API連携の観点では、ここに送る価値のあるリクエストは次の3種類です。
- 正確な文字を含むポスター、ラベル、SNS画像:プロンプト内でテキストを引用符で囲みます。
- それ以外を一切変えてはいけない編集:チラシの日付の差し替え、製品の再着色、1か所のディテール変更など。
- 大判プリント:別途アップスケーリングを行わずに、1辺最大4096ピクセルのカスタムサイズで出力。
Ideogram 4.6 APIの概要
| テキストから画像 | 編集 | |
|---|---|---|
| PoYoのモデルID | ideogram-v4.6 | ideogram-v4.6-edit |
| 送信エンドポイント | POST https://api.poyo.ai/api/generate/submit | 同じ |
| 結果の取得 | GET /api/generate/status/{task_id}をポーリング、またはcallback_urlを使用 | 同じ |
| 入力 | prompt | prompt + image_urlsにちょうど1枚の画像、任意でmask_urlとreference_image_urls |
| リクエストあたりの画像数 | 1〜8(n) | 1〜8(n) |
| 品質レベル | very_low、low、medium(デフォルト)、high | 同じ |
| Ideogramのリリース日 | 2026年11月19日 | 2026年11月19日 |
| ドキュメント | Ideogram V4.6 APIリファレンス | Ideogram V4.6 Editリファレンス |
2つのIDは認証、ポーリング、課金を共有しているため、アプリは一方で生成し、もう一方で仕上げるという使い方を、追加の連携なしで実現できます。
上限とリクエストフィールド
| フィールド | PoYoでのルール |
|---|---|
prompt | 必須、1〜10,000文字、空白以外の文字を含む必要があります。画像内に入れる正確なテキストは引用符で囲みます。 |
size | auto(デフォルト)、1:1(512×512)、1:1 HD(1024×1024)、4:3、3:4、16:9、9:16、またはカスタムのWIDTHxHEIGHT |
| カスタムサイズ | 小文字のx、両辺とも256〜4096ピクセルかつ32の倍数、アスペクト比は1:6〜6:1の範囲 |
quality | very_low、low、medium(デフォルト)、high。very_lowは4,194,304ピクセルまでのみ |
n | 1〜8の整数 |
background | transparentまたはopaque。テキストから画像と通常の編集のみ |
seed | 0〜2,147,483,647の整数 |
image_urls(編集) | ソース画像はちょうど1枚。公開HTTP(S) URLまたはbase64データURIで、常に配列 |
mask_url(編集) | ソースと同じ寸法。黒が編集され、白が保持されます。size: autoが必要 |
reference_image_urls(編集) | 0〜4枚、マスク使用時は最大3枚 |
edit_precision(編集) | regular(デフォルト)またはhigh。highはsize: autoが必要で、backgroundを受け付けません |
context_window(編集) | none(デフォルト)またはauto。autoにはmask_urlとedit_precision: highが必要 |
input内のそれ以外のフィールドはunsupported fieldsエラーで拒否されます。生成ファイルは3日間保持されるので、自社のストレージにコピーしてください。
Ideogram 4.6 APIの料金
PoYoは出力画像1枚ごとに、品質とサイズのティアに応じて課金します。「2K」は最大4,194,304ピクセル(面積で2048×2048)の出力を指し、それより大きいものはすべて「4K」です。1 credit = $0.005です。
| 品質 | テキストから画像 2K | テキストから画像 4K | 編集 2K | 編集 4K |
|---|---|---|---|---|
very_low | 1.6 credits ($0.008) | 利用不可 | 1.6 credits ($0.008) | 利用不可 |
low | 6 credits ($0.03) | 12 credits ($0.06) | 6 credits ($0.03) | 12 credits ($0.06) |
medium | 12 credits ($0.06) | 24 credits ($0.12) | 12 credits ($0.06) | 40 credits ($0.20) |
high | 20 credits ($0.10) | 40 credits ($0.20) | 44 credits ($0.22) | 120 credits ($0.60) |
テキストから画像では、size: autoと6つのプリセットは常に2Kです。size: autoの編集では出力がソースの寸法を保つため、大きなソースは4Kティアになります。これらの料金はIdeogramのモデルページにある画像あたりの料金表と一致しています。料金の詳細解説では、実際のリクエスト形状で計算例を示しています。
ローンチ当日に計測した結果
PoYoチームは2026年11月20日、PoYoの本番APIで以下を実行しました。プロンプトはシルクスクリーン風の「NORTHBOUND JAZZ FESTIVAL」ポスターで、「JUNE 12-14 · RIVERSIDE PARK」と「Three nights. Twenty-one bands. Free entry before 6 PM.」の行を含みます。
| タスク | リクエスト | 出力 | 課金額 |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6、quality: high、size: 2304x3072、n: 1 | 2304×3072のPNG 1枚、約10.8 MB | 40 credits ($0.20) |
BS7M64COKT80JSLX | 同じプロンプト、quality: very_low、size: 3:4 | 768×1024のPNG | 1.6 credits ($0.008) |
672JRU198S22NS8D | 最初のポスターにideogram-v4.6-edit、edit_precision: high、context_window: none、size: auto、quality: high | 2304×3072のPNG | 120 credits ($0.60) |
最初の2枚のポスターでは、小さなイタリック体の行も含め、すべてのテキストが指定どおりに描画されました。ドラフトは構図が異なっていました。編集プロンプトは「Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same.」です。元画像とのピクセル差分を取ったところ、変更されたピクセルはすべて(471, 2699)から(1826, 2756)の1つのボックス内、画像全体の約1.1%に収まり、残りは変化していませんでした。高精度編集はソースの解像度を保つため、この編集は4Kのhighティアで課金されました。このリクエストの詳細はテキストと精密編集ガイドで解説しています。
最初のIdeogram 4.6 APIリクエスト
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.6",
"input": {
"prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
"size": "2048x3072",
"quality": "high",
"n": 2
}
}'
2048x3072は6,291,456ピクセルなので、このリクエストは4Kのhigh料金で課金されます:2 × 40 = 80 credits($0.40)。レスポンスにはdata.task_idとステータスnot_startedが含まれます。ステータスがfinishedになるまでステータスエンドポイントをポーリングしてdata.filesから画像を読み取るか、トップレベルでcallback_urlを渡します。ボディ内のcodeは必ず確認してください。一部のバリデーションエラーはHTTP 200でcode: 400を返します。APIガイドには、上限付きのPythonポーリングループと、すべての入力モードのボディ例があります。
Ideogram 4.6を利用できる場所
Ideogramは自社のアプリとAPIで4.6を提供しており、エンドポイントはGenerateとPrecise Editの2つです。PoYoでは、他のすべてのモデルと同じキー、同じタスクとコールバックのフローで呼び出せます。また、モデルページのPlaygroundでは実行前に料金が表示されます。PoYoでは参照画像はideogram-v4.6-edit経由で渡します。テキストから画像のIDが受け付けるのは、プロンプトとsize、quality、n、background、seedの各コントロールのみです。
リクエストごとの振り分け
| リクエスト | モデルIDと設定 |
|---|---|
| ドラフトとレイアウトの検討 | ideogram-v4.6、very_lowまたはlow、プリセットサイズ、nは最大8 |
| 面積2048×2048までの最終ポスターとSNS画像 | ideogram-v4.6、high、1728x2304などのカスタムサイズ |
| 印刷物と大判アート | ideogram-v4.6、low〜high、4,194,304ピクセルを超えるカスタムサイズ |
| 1か所だけ変えて残りを保持 | ideogram-v4.6-edit、edit_precision: high |
| 大きな画像の1領域だけを描き直す | ideogram-v4.6-edit、mask_url、edit_precision: high、context_window: auto |
| 参照画像でスタイル変更し、出力サイズも変える | ideogram-v4.6-edit、edit_precision: regular、reference_image_urls、カスタムsize |
Ideogram 4.5から移行する場合は、4.6と4.5の比較でフィールドの変更点、新しいサイズルール、同じリクエストでの料金を確認できます。PoYoの他の画像APIと比較検討する場合は、MAI Image 2.7 APIの概要とKling Image 4.0、GPT Image 2.6、Seedream 5.5の比較をご覧ください。
よくある質問
Ideogram 4.6 APIのモデルIDは?
テキストから画像にはideogram-v4.6、編集にはideogram-v4.6-editを使います。ideogram-4-6はPoYoのページスラッグにすぎず、モデルIDではありません。
Ideogram 4.6 APIの料金は?
very_lowの2Kで1枚あたり1.6 credits($0.008)からです。デフォルトのmediumの2K画像は12 credits($0.06)、highは2Kで20 credits($0.10)、4Kで40 credits($0.20)です。高品質の4K編集は120 credits($0.60)です。
Ideogram 4.6 APIが返せる最大の画像は? カスタムサイズは1辺最大4096ピクセル、32の倍数で、アスペクト比は1:6〜6:1の範囲です。4,194,304ピクセルを超えるものはすべて4Kティアで課金されます。
Ideogram 4.6 APIは画像内にテキストを描画できますか? はい。正確な文言をプロンプト内で引用符で囲んでください。ローンチ当日のテストでは、2304×3072のポスターで見出し、日付の行、小さなイタリック体の行が指定どおりに描画されました。それでもIdeogramは、最終結果でスペルと配置を確認するよう勧めています。
Ideogram 4.6 APIは透過画像を返せますか?
はい。テキストから画像または通常の編集でbackgroundをtransparentに設定します。高精度編集ではbackgroundは拒否されます。
Ideogram 4.6 APIはOpenAI SDKと互換性がありますか?
いいえ。非同期タスクAPIです。/api/generate/submitに送信し、/api/generate/status/{task_id}をポーリングするか、コールバックを受け取ります。