3行でいうと
- 公式のAPI（API Docsは「v2」）は、「POST /v2/{content}/{action}/{model}」という共通の形で、モデル名をURLに入れて呼び出します。認証はAPIキーを「Api-Key」ヘッダーに付けます。
- 公式のMCPは、エンドポイント「https://mcp.ideogram.ai/mcp」で、Claude、Claude Code、ChatGPT、Cursorなどから使えます。認証は、Ideogramのアカウントでのサインイン（OAuth）です。
- APIの文書には、Ideogramのモデルのほかに、GPT Image 2.5、Nano Banana、Seedance 2.5、Kling v3 Standard、MiniMax H3、Topazの拡大モデルなどが並んでいます。それぞれの提供元は、読んだ範囲の公式の資料には書かれていませんでした。
- Ideogram 4.0は、GitHubとHugging Faceから重みを入手して手元で動かせます。商用利用の条件は「Ideogram Non-Commercial Model Agreement」と、有料の商用ライセンスで分かれます。
- 第三者が作った連携は、公式の資料の範囲では読んでいません。APIのページに並ぶ他社サービスのロゴが、Ideogramのモデルを提供しているかは、公式ページに書かれていません。
この記事は、公式の資料を2026年10月24日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。API文書は、取得できたページだけの内容を書いています。API料金の一覧は「読み込み中」の表示のままで、読めていません。
先に結論
- 公式運営と言えるもの。 API（developer.ideogram.ai）、MCP（ideogram.ai/features/mcp/）、オープンウェイト（GitHubの「ideogram-oss」、Hugging Faceの「ideogram-ai」。どちらも公式トップページの開発者メニューが案内しています）。
- Ideogramの中で選べる、名前から他社製と見えるモデル（僕らの見立て）。 API文書の「Images」の「Generate」には、Ideogram自身のモデルと並んで、GPT Image 2.5 Flare、GPT Image 2.5 Sunburst、GPT Image 2、Nano Banana 2、2.1、Pro、Z-Image が載っています。動画と拡大にも、Seedance、Kling、MiniMax H3、Topaz の名前があります。公式の文書は、これらを「他社のモデル」とも「第三者」とも書かず、提供元の会社名も書いていません。名前から他社のモデルと見える、というのは僕らの見立てで、公式の説明ではありません。
- 第三者製。 公式の資料の範囲では、第三者が作ったIdeogramの連携は読んでいません。調べたい場合は、公式が案内するものだけを出発点にしてください。
- データの流れ。 APIやMCPを使うと、プロンプトや画像は、Ideogramのサーバーに送られます。MCPでは、使っているAIエージェント側（ClaudeやChatGPTなど）にも会話が渡ります（一般的な仕組みの説明で、各社の扱いは各社の規約で確かめてください）。
前提：用語をそろえる
- API：ほかのプログラムからIdeogramを呼び出す窓口です。
- APIキー：自分のアカウントとして呼び出すための合言葉のようなものです。人に見せてはいけません。公式の説明では、作ったときに一度しか全体が表示されません。
- MCP：AIエージェントを外部の道具につなぐ規格です。
- OAuth：パスワードを渡さずに、ブラウザーでサインインして許可を与える仕組みです。
- Webhook（ウェブフック）：生成が終わったときに、Ideogramから自分のサーバーへ結果を送ってもらう仕組みです。
- オープンウェイト：モデルの重みを公開し、手元で動かせる形のことです。
- 名前から他社製と見えるモデル：この記事では、名前から他社が作ったと見えるもの（公式の文書は提供元を書いていません）を、僕らの見立てとしてこう呼びます。
公式が運営するもの
| 連携 | 何ができるか（公式の書き方） | 区分 | どこに書かれているか |
|---|---|---|---|
| API（v2） | 画像と動画のモデルを、ひとつの呼び出し方で使える。画像は生成、Remix、Inpaint、Reframe、Upscale、背景の入れ替えと削除、物の削除、Describe、Layerize。動画は生成。SVGは生成と変換。広告などのツール群もある | 公式 | developer.ideogram.ai/ideogram-api/api-overview |
| MCP | MCP対応のAIエージェントが、会話の中で画像の生成、編集、モデルの学習をできるようにするサーバー。見出しは「Add Ideogram to any AI agent」 | 公式 | ideogram.ai/features/mcp/ |
| Claude Code向けの手引き（スキル） | 公式ブログが、MCPと、プロンプトの技を使い回せる「/ideogram-prompt」というスキルを紹介している | 公式（ブログの紹介） | ideogram.ai/blog/claude-mcp/ |
| オープンウェイト | Ideogram 4.0の重みをGitHubとHugging Faceで入手できる。推論のコードはGitHub | 公式 | ideogram.ai/models/4.0/、github.com/ideogram-oss |
| Webの書き出し | 画像のダウンロード。透明用のモデルや「Background Remover」ではPNGの透明画像。Vectorでは「SVG」。Studioは画像のみで、PSDやSVGは書き出せない | 公式 | 各機能ページ、公式ブログ |
| カスタムモデルの学習（API） | データセットを作り、10〜100枚の画像を入れ、1回のPOSTで学習を始める | 公式 | ideogram.ai/models/custom-models/ |
APIの基本（公式の文書から読めたこと）
- キーの作り方。 API Setupの手引きは、ideogram.aiにログインし（無料のアカウントで足りる）、アプリの「API」ボタンまたはアカウントメニューの「API keys」でキーを作る、と書いています。サインアップのときに、利用規約と並んで「Developer API Agreement and Policy」に同意することになる、とも書かれています。この契約書の本文は、僕らは読めていません。
- 支払い。 APIは前払い（prepaid）で、リクエストごとにクレジット残高が減ります。1回の購入は、10・20・50・100ドルの定額か、1〜300ドルの任意の金額で、残高は300ドルを超えられません。自動チャージは初期設定ではオフです。決済はStripeが処理すると書かれています。Ideogramの購読プランを持っている場合は、そのクレジットが先に使われます（リクエスト全体をまかなえるとき）。
- キーの管理。 どのキーもアカウントの全権限を持ち、残高は共有です。取り消しはいつでもできますが、元に戻せません。
- 非同期。 動画とツールのエンドポイントは、いつも非同期です。画像は「async」を付けるか、Webhookのアドレスを渡すと非同期になります。結果は「generation_id」で確かめるか、Webhookで受け取ります。Webhookの配信は保証されず、ポーリングを併用するよう書かれています。Webhookの本文は、Ed25519の署名つきです。
- 画像のURL。 「image URLs expire」、つまり期限があるので、残したいものはダウンロードするよう書かれています。期限の長さは、読んだ範囲では書かれていませんでした。
- レート制限。 初期値は「同時に処理中のリクエスト10件」です。増やしたい場合は、連絡先のメールアドレス（partnership@ideogram.ai）が案内されています。
- 見積りだけ試す。 生成を実行せず、請求もされずに、料金の見積りを返す「dry_run」があります。
MCPの基本（公式のMCPのページから読めたこと）
- エンドポイントは「https://mcp.ideogram.ai/mcp」（ストリーミングできるHTTP）です。
- 使えるクライアントとして、Claude、Claude Code、ChatGPT、Cursor、Cline、OpenCode、Hermes Bot、自作のクライアントが挙がり、それぞれの設定例が載っています。Claude Codeでは「claude mcp add ideogram --transport http https://mcp.ideogram.ai/mcp」と書かれています。ChatGPTについては、PlusとProで、デスクトップアプリの「Connectors」パネルから使える、と書かれています。
- 認証は、最初の接続のときにブラウザーが開き、Ideogramのアカウントでサインインします（OAuth）。APIキーは扱いません。
- 料金は、Webアプリと同じ購読のクレジットから引かれ、「There is no separate billing for MCP requests」と書かれています。
- MCPは、利用者に代わって動くエージェント向けで、サーバー同士で動かす処理にはREST API（開発者向けの文書）を案内しています。
- 使える道具（ツール）の全一覧は、ページにはありません。例として、画像の一括生成、コレクションの作成、拡大、編集、縦横比の変更、画像のアップロード、データセットの作成、モデルの学習などが挙がっています。公式ブログは別の名前（「generate_image」「describe_image」「remix_image」など）を書いており、名前の揺れがあります。僕らは、どれが現在の正式名かは確認できていません。
- ベータの表示は、MCPのページには見つかりませんでした。
Ideogramの中で選べる、名前から他社製と見えるモデル
API文書は、モデルを次のように並べています。「他社製と見える」かどうかの区分は、公式の文書にはなく、僕らの見立てです。
| 区分 | 公式の表示のまま | 提供元についての記載 |
|---|---|---|
| Ideogram自身のモデル | 4.5（Precise Editと生成）、4.0（透明用、カスタムを含む）、3.0、2a、2.0、Ideogram 1（背景の削除と物の削除のエンドポイントが使うモデル）、P-Image Ideogram（Pruna AIと共同） | Ideogram |
| 名前から他社製と見える画像モデル（僕らの見立て） | GPT Image 2.5 Flare、GPT Image 2.5 Sunburst、GPT Image 2、Nano Banana 2、Nano Banana 2.1、Nano Banana Pro、Z-Image | 公式の文書は「第三者」と区分せず、提供元の会社名も書いていない（Generateの一覧に並ぶだけ） |
| 拡大（Topaz） | Bloom 2、Redefine、Standard V2、Text Refine、Wonder 3.5 | モデル名に「Topaz」とある（Topaz Bloom 2 など） |
| 動画 | Seedance 2.5、Seedance 2.0、MiniMax H3、Kling v3 Standard（文章から、画像から、参照から、のうち、モデルごとに異なる） | 文書の見出しは「Video」。提供元の記載は読んだ範囲では見つからなかった |
- 「P-Image Ideogram」は、API文書では他の画像モデルと同じ一覧に並んでいます。モデルのページ（P-Image-Ideogram）は、Ideogramのモデルで「Pruna AIと作った」と書いています。
- 公式トップページのFAQ（「Which image and video models are available?」）は、カタログは「Ideogramのモデルと、主要な研究機関のモデルをまとめたもの」で、提供は増えていく、と書いています。ただし、個々の会社名は書かれていません。
- 公式の料金ページは、Plusの特典に「すべての画像・動画モデル」という趣旨を書いています。Webの画面でどのモデルが選べるかの一覧は、公式の資料では確認できていません。
- 文書のモデルの例：GPT Image 2.5 Flareは、文書の説明で「GPT Image 2.5の高速な版」とされ、参照画像は最大16枚（1枚25MBまで）、品質は「low、medium、high」などです。Nano Banana 2.1は、解像度の区分が「1K、2K、4K」、参照画像は最大10枚です。Seedance 2.5（文章から動画）は、長さ4〜30秒、解像度480p、720p（初期値）、1080p、音声は初期値がオフで、文書は「音声は提供元の費用をおよそ倍にし、出力の審査も厳しくなる」という趣旨を書いています。値段はこの文書には載っていません。
- 4.0や4.5以外のモデルで作った画像の権利や、そのモデルの提供元の規約が適用されるかは、読んだ範囲の公式の資料では確認できていません。使う前に、Ideogramの規約と、料金ページの説明を確かめてください。
手元で動かす（オープンウェイト）
- 公式の4.0のページは、重みを、微調整や自分のハードウェアで動かすためにGitHubとHugging Faceからダウンロードできる、と書いています。
- GitHubのREADMEは、「Ideogram 4」を約93億パラメーターのモデルと書き、nf4とfp8の2つの版を挙げています。Hugging Faceの一覧は、nf4を5B、fp8を9Bと表示しており、数字が食い違っています。僕らは確認できていません。
- READMEの導入手順は、Hugging Face上で重みの「gate（利用の同意）」を受け入れ、トークンで認証する、という流れです。必要なVRAM（GPUのメモリ）は、READMEには書かれていませんでした。公式ブログは「nf4版は24GBのGPU1枚に収まる」と書いています。
- READMEは、オプションとして、安全性の確認にHiveというサービスの鍵を使えると書いています。これを有効にすると、確認の対象が外部のサービスに送られる、と読めます（僕らの読み取りです）。
- ライセンスは、コードがApache-2.0、モデルの重みは「Ideogram 4 Non-Commercial」（READMEの表記）。公式のライセンスページは「Ideogram Non-Commercial Model Agreement」の名前で、研究、評価、試作、個人の用途は無料、商用には「Self-Serve Commercial License（月300ドル、年払いは割引と書かれている）」か「Enterprise」が必要、と書いています。Self-Serve Commercial Licenseは「月1万枚」の枠、Enterpriseは「月10万枚超」の場合と書かれています。条件の詳細は、ライセンスページの原文で確かめてください。
第三者・コミュニティ製
- 公式のAPIのページには、14社のロゴ（見出しや説明はなし）（例：Replicate、ComfyUI、Leonardo AI、Together AI）が並んでいますが、各社がIdeogramのモデルを提供しているかは、ページに書かれていません。僕らは確認できていません。
- MCPのページが設定例を載せているクライアント（Cline、OpenCode、Hermes Botなど）は、Ideogramが作ったものではなく、各クライアントの提供元のものです。
- ほかに、Ideogramを呼ぶ第三者のプラグインや拡張機能があるかもしれませんが、僕らは公式の資料の範囲で読んでいません。使う場合は、そのプラグインの作者の規約とデータの扱いを、別に確かめてください。
データはどこへ流れるか
| 使い方 | 送られるもの | 送り先 | 公式の説明 |
|---|---|---|---|
| Web・iPhoneアプリ | プロンプト、アップロードした画像 | Ideogram | プライバシーポリシーは、プロンプトやアップロードした画像などを集めると書いている（04で扱う） |
| API | プロンプト、参照画像（1枚25MBまでなどの上限） | Ideogramのサーバー（api.ideogram.ai） | 画像のURLに期限がある。入力と出力の保存期間は、読んだ範囲では書かれていなかった |
| MCP | プロンプトと画像（エージェント経由） | Ideogram（mcp.ideogram.ai）と、使っているAIエージェントの提供元 | OAuthのトークンを使う。エージェント側の扱いは、それぞれの規約 |
| Webhook | 生成の結果（画像のURLなど） | 自分が指定したアドレス（HTTPSのみ、などの条件は、読んだ範囲の公式の資料では確認できていません） | 署名つき |
| 手元で動かす（オープンウェイト） | 自分のコンピューターで処理 | 手元（Hiveの確認を有効にした場合を除く） | READMEの説明 |
- 生成の結果に「is_image_safe」という項目があり、4.5のAPIには「enable_copyright_detection」というオプションがあります。確認の仕組みの詳細は、読んだ範囲では書かれていませんでした。
- APIやMCPで作った画像が、Webアプリのように公開されることがあるかは、公式の資料では確認できていません。
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式の資料を読んだ範囲です。
- API料金の一覧は「読み込み中」の表示のままで、読めていません。各モデルのページに載っている価格は、04で扱います。
- API文書は、v2が現在版で、v1も残っています。名前や項目が変わる場合があります。
- ブログやAPIページには、名前や数字の揺れがあります（MCPのツール名、4.0のパラメーター数など）。
- 名前から他社製と見えるモデルの提供元と、そのモデルを通したときのデータの扱いは、公式の資料で確認できていません。
- モデルの名前と版は変わります。この記事の名前は、2026年10月24日に公式ページで読んだ表示のままで、「どれが最新か」は断定しません。規約は変わります。使う前に、公式で最新を読んでください。
出典
- Ideogram（トップページ、Ideogram、確認日 2026-10-24）
- Ideogram MCP（Ideogram、確認日 2026-10-24）
- Ideogram API（Ideogram、確認日 2026-10-24）
- API Overview（Ideogram developer docs、確認日 2026-10-24）
- API Setup（Ideogram developer docs、確認日 2026-10-24）
- Webhooks（Ideogram developer docs、確認日 2026-10-24）
- Generate with Ideogram 4.5（Ideogram developer docs、確認日 2026-10-24）
- Generate with GPT Image 2.5 Flare（Ideogram developer docs、確認日 2026-10-24）
- Generate with Nano Banana 2.1（Ideogram developer docs、確認日 2026-10-24）
- Seedance 2.5 text to video（Ideogram developer docs、確認日 2026-10-24）
- Describe with Ideogram 4.0（Ideogram developer docs、確認日 2026-10-24）
- P-Image-Ideogram（Ideogram、確認日 2026-10-24）
- Custom Image Models（Ideogram、確認日 2026-10-24）
- Ideogram 4.0（Ideogram、確認日 2026-10-24）
- Licensing（Ideogram、確認日 2026-10-24）
- ideogram-4 リポジトリのREADME（GitHub、ideogram-oss、確認日 2026-10-24）
- Ideogram 4 コレクション（Hugging Face、ideogram-ai、確認日 2026-10-24）
- The Ideogram 4.0 Prompt Guide（Ideogram公式ブログ、2026-06-12、確認日 2026-10-24）
- Ideogram 4.0 Technical Details（Ideogram公式ブログ、2026-06-03、確認日 2026-10-24）