Skip to main content

Ideogram V3 インターフェース

Ideogram V3モデルは、高度な画像生成および処理機能を提供します。V3インターフェースは以前のバージョンとはパラメータと使用方法が異なります。このセクションでは、V3の各インターフェースと使用例を詳しく説明します。

V3 Generate

POST https://aihubmix.com/ideogram/v1/ideogram-v3/generate 指定されたプロンプトに基づいて画像を生成します。V3モデルは、より高品質な画像生成機能を提供し、より豊かなスタイルとパラメータ制御をサポートします。
string
必須
画像を生成するためのプロンプト
string
デフォルト:"DEFAULT"
レンダリング速度オプション。TURBODEFAULTQUALITYから選択可能
integer
デフォルト:"1"
一度に生成する画像の数。範囲は1〜8
画像の数を増やしても、生成にかかる時間はほとんど増えません
string
デフォルト:"1x1"
画像生成に使用するアスペクト比。非常に多くの仕様をサポート
選択可能: [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
V3以下のモデルで使用されるASPECT_10_16タイプの仕様とは異なります。
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTOONOFF
string
デフォルト:"AUTO"
生成する画像のスタイルタイプ。AUTOGENERALREALISTICDESIGNから選択可能
V2バージョンと比較して、タイプがより絞り込まれています
string
画像に表示したくない内容を記述
integer
ランダムシード。範囲:0〜2147483647
一度に複数の画像を生成する場合は、同じ画像が生成されるためシードを使用しないでください
file
スタイル参照画像。スタイルガイドとして使用可能

呼び出し例

V3 Remix

POST https://aihubmix.com/ideogram/v1/ideogram-v3/remix 参照画像に基づいて、プロンプトに従って画像を再生成します。V3のRemix機能は、元の画像のスタイルとコンテンツをより良く保持する能力があります。
string
必須
画像を再描画するためのプロンプト
file
必須
元の画像ファイル
integer
デフォルト:"50"
元の画像の影響度。範囲は1〜100で、数値が大きいほど元の画像に似た結果になります。
string
デフォルト:"DEFAULT"
レンダリング速度オプション。TURBODEFAULTQUALITYから選択可能
integer
デフォルト:"1"
一度に生成する画像の数。範囲は1〜8
string
出力画像のアスペクト比。選択可能: [‘1x3’, ‘3x1’, ‘1x2’, ‘2x1’, ‘9x16’, ‘16x9’, ‘10x16’, ‘16x10’, ‘2x3’, ‘3x2’, ‘3x4’, ‘4x3’, ‘4x5’, ‘5x4’, ‘1x1’]
file
スタイル参照画像。スタイルガイドとして使用可能
integer
ランダムシード。範囲:0〜2147483647
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTOONOFF
string
デフォルト:"AUTO"
生成する画像のスタイルタイプ。AUTOGENERALREALISTICDESIGNから選択可能
string
画像に表示したくない内容を記述

呼び出し例

V3 Edit

POST https://aihubmix.com/ideogram/v1/ideogram-v3/edit V3のローカル編集機能を使用すると、元の画像とマスクを提供することで、画像の特定の領域を正確に編集し、他の領域は変更せずに維持できます。
string
必須
画像を編集するためのプロンプト
file
必須
元の画像ファイル
file
必須
マスク画像。黒い領域は編集が必要な部分、白い領域は変更しない部分を示します。
string
デフォルト:"DEFAULT"
レンダリング速度オプション。TURBODEFAULTQUALITYから選択可能
integer
デフォルト:"1"
一度に生成する画像の数。範囲は1〜8
string
出力画像のアスペクト比
integer
ランダムシード。範囲:0〜2147483647
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTOONOFF
string
デフォルト:"AUTO"
生成する画像のスタイルタイプ。AUTOGENERALREALISTICDESIGNから選択可能
string
画像に表示したくない内容を記述

呼び出し例

V3 Replace Background

POST https://aihubmix.com/ideogram/v1/ideogram-v3/replace-background V3の背景置換機能は、画像の前景と背景をインテリジェントに認識し、プロンプトに基づいて背景を置換しながら、前景オブジェクトは変更せずに維持します。
string
必須
背景を置換するためのプロンプト
file
必須
元の画像ファイル
string
デフォルト:"DEFAULT"
レンダリング速度オプション。TURBODEFAULTQUALITYから選択可能
integer
デフォルト:"1"
一度に生成する画像の数。範囲は1〜8
file
スタイル参照画像。スタイルガイドとして使用可能
integer
ランダムシード。範囲:0〜2147483647
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTOONOFF
string
デフォルト:"AUTO"
生成する画像のスタイルタイプ。AUTOGENERALREALISTICDESIGNから選択可能

呼び出し例

その他のオプションパラメータについては、Ideogram AI 公式ガイドを参照してください。

💰 V3 料金


V2-V1 インターフェースの説明

Ideogram AI V2-V1描画インターフェースは、強力なテキスト描画機能を持ち、画像生成(generate)、混合(remix)、部分編集(edit)、拡大(upscale)、記述(describe)などをサポートしています。
  • 混合: 参照画像に基づいて、プロンプトに従って画像を再描画し、新しい画像を生成します。
  • 編集: 参照画像に基づいて、プロンプトとマスクに従って画像を部分的に編集し、新しい画像を生成します。
  • 拡大: 低解像度の画像を高解像度に拡大し、細部を再描画します(類似度と細部の比率を制御可能)。
  • 記述: プロンプトの逆推論で、画像を記述するために使用されます。
サポートされているスタイル:
  • AUTO:デフォルトの自動選択
  • GENERAL:汎用
  • REALISTIC:写実的
  • DESIGN:デザイン
  • RENDER_3D:3D
  • ANIME:アニメ
  • スタイルパラメータstyle_typeはV_2以降のモデルにのみ適用され、V_1バージョンでは指定しないでください。
  • V3のサポートは近日公開予定です
  1. AiHubMix公式インターフェースまたはCherry Studio APPを介して呼び出すことができます。現在、画像を生成するにはプロキシを有効にする必要があることに注意してください。
  2. Cherry Studioは現在、Ideogramの描画(generate)インターフェースのみを公開しています。

Generate

POST [https://aihubmix.com/ideogram/generate](https://api.aihubmix.com/ideogram/generate) 指定されたプロンプトとオプションのパラメータに基づいて画像を同期的に生成します。画像リンクの有効期限は限られています。画像を保持したい場合は、ダウンロードして保存する必要があります。 リクエストパラメータ
object
必須
画像を生成するためのリクエストオブジェクト
string
必須
画像を生成するためのプロンプト
string
デフォルト:"ASPECT_1_1"
画像生成に使用するアスペクト比。画像の解像度を決定します。解像度パラメータと同時に使用することはできません。利用可能な比率:
  • ASPECT_1_1
  • ASPECT_3_1
  • ASPECT_1_3
  • ASPECT_3_2
  • ASPECT_2_3
  • ASPECT_4_3
  • ASPECT_3_4
  • ASPECT_16_9
  • ASPECT_9_16
  • SPECT_16_10
  • ASPECT_10_16
string
デフォルト:"V_2"
画像を生成または編集するためのモデル。/generateと/remixはすべてのモデルタイプをサポートしますが、/editはV_2とV_2_TURBOのみをサポートします。利用可能なモデルバージョン:
  • V_1
  • V_1_TURBO
  • V_2
  • V_2_TURBO
  • V_2A
  • V_2A_TURBO
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTO、ON、OFF
integer
ランダムシード。範囲:0〜2147483647
string
デフォルト:"AUTO"
画像を生成する際に使用するスタイルタイプ。このパラメータはV_2以降のモデルにのみ適用され、V_1バージョンでは指定しないでください。利用可能なスタイル:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME
string
画像に表示したくない内容を記述します。モデルバージョンV_1、V_1_TURBO、V_2、V_2_TURBOにのみ適用されます。プロンプトの記述はネガティブプロンプトの記述よりも優先されます。
integer
デフォルト:"1"
一度に生成する画像の数。範囲は1〜8
string
画像生成に使用する解像度(モデルバージョン2.0にのみ適用され、aspect_ratioと同時に使用することはできません)。幅x高さで表されます。指定しない場合、デフォルトでaspect_ratioが使用されます。

呼び出し例

Response

画像が正常に生成されました。

エラーコード

  • 400 : 画像生成リクエストの不正なリクエストエラー
  • 401 : 画像生成リクエストの認証エラー
  • 422 : 画像生成リクエストの処理不能エンティティエラー
  • 429 : 画像生成リクエストの多すぎるリクエストエラー

Edit

POST https://aihubmix.com/ideogram/edit 提供されたマスクを使用して、指定された画像を同期的に編集します。マスクは編集すべき画像の部分を示し、プロンプトと選択されたスタイルタイプは編集の方向をさらにガイドします。サポートされている画像形式はJPEG、PNG、WebPです。画像リンクの有効期限は限られています。画像を保持したい場合は、ダウンロードして保存する必要があります。 リクエストパラメータ
file
必須
元の画像ファイル。JPEG、PNG、WebP形式をサポート
file
必須
マスク画像。以下の要件を満たす必要があります。
  • 黒と白のピクセルのみを含み、RGB、RGBA、またはグレースケール画像形式をサポート
  • 元の画像と完全に同じサイズ
  • 黒い領域は変更が必要な部分、白い領域は変更しない部分を示します
  • 純粋な白色であってはなりません
  • 変更領域(黒い部分)は画像の少なくとも10%以上を占めることを推奨
string
必須
部分編集用のプロンプト
string
必須
画像を生成または編集するためのモデル。/generateと/remixはすべてのモデルタイプをサポートしますが、/editはV_2とV_2_TURBOのみをサポートします。利用可能なモデルバージョン:
  • V_2
  • V_2_TURBO
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTO、ON、OFF
integer
デフォルト:"1"
一度に生成する画像の数。範囲は1〜8
integer
ランダムシード。範囲:0〜2147483647
string
デフォルト:"AUTO"
画像を生成する際に使用するスタイルタイプ。このパラメータはV_2以降のモデルにのみ適用されます。利用可能なスタイル:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME

呼び出し例

Response

画像編集が正常に生成されました。

エラーコード

  • 400 : 画像編集リクエストの不正なリクエストエラー
  • 401 : 画像編集リクエストの認証エラー
  • 422 : 画像編集リクエストの処理不能エンティティエラー
  • 429 : 画像編集リクエストの多すぎるリクエストエラー

Remix

POST https://aihubmix.com/ideogram/remix 提供された画像とプロンプトに基づいて新しい画像を生成します。入力画像は、選択されたアスペクト比に合わせてトリミングされます。サポートされている画像形式はJPEG、PNG、WebPです。画像リンクの有効期限は限られています。画像を保持したい場合は、ダウンロードして保存する必要があります。 リクエストパラメータ
object
必須
提供された画像とプロンプトを使用して新しい画像を生成するためのリクエスト。提供された画像は、選択された出力アスペクト比に合わせてトリミングされます。
string
必須
画像を生成するためのプロンプト
string
デフォルト:"ASPECT_1_1"
画像生成に使用するアスペクト比。画像の解像度を決定します。解像度パラメータと同時に使用することはできません。利用可能な比率:
  • ASPECT_1_1
  • ASPECT_3_1
  • ASPECT_1_3
  • ASPECT_3_2
  • ASPECT_2_3
  • ASPECT_4_3
  • ASPECT_3_4
  • ASPECT_16_9
  • ASPECT_9_16
  • SPECT_16_10
  • ASPECT_10_16
integer
デフォルト:"50"
参照画像の重み。範囲:1〜100
string
デフォルト:"V_2"
画像を生成または編集するためのモデル。/generateと/remixはすべてのモデルタイプをサポートしますが、/editはV_2とV_2_TURBOのみをサポートします。
string
画像に表示したくない内容を記述します。モデルバージョンV_1、V_1_TURBO、V_2、V_2_TURBOにのみ適用されます。プロンプトの記述はネガティブプロンプトの記述よりも優先されます。
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTO、ON、OFF
integer
デフォルト:"1"
一度に生成する画像の数。範囲:1〜8
string
画像生成に使用する解像度(モデルバージョン2.0にのみ適用され、aspect_ratioと同時に使用することはできません)。幅x高さで表されます。指定しない場合、デフォルトでaspect_ratioが使用されます。
integer
ランダムシード。範囲:0〜2147483647
string
デフォルト:"AUTO"
画像を生成する際に使用するスタイルタイプ。V_2以降のモデルにのみ適用され、V_1バージョンでは指定しないでください。利用可能なスタイル:
  • AUTO
  • GENERAL
  • REALISTIC
  • DESIGN
  • RENDER_3D
  • ANIME
file
必須
元の画像ファイル。JPEG、PNG、WebP形式をサポート

呼び出し例

Response

画像が正常に生成されました。

エラーコード

  • 400 : 画像合成リクエストの不正なリクエストエラー
  • 401 : 画像合成リクエストの認証エラー
  • 422 : 画像合成リクエストの処理不能エンティティエラー
  • 429 : 画像合成リクエストの多すぎるリクエストエラー

Upscale

POST https://aihubmix.com/ideogram/upscale オプションのプロンプトを使用して、提供された画像を同期的に拡大(超解像)します。サポートされている画像形式はJPEG、PNG、WebPです。画像リンクの有効期限は限られています。画像を保持したい場合は、ダウンロードして保存する必要があります。 リクエストパラメータ
object
必須
オプションのプロンプトを使用して、提供された画像を拡大するためのリクエストオブジェクト
string
拡大プロセスをガイドするためのオプションのプロンプト
integer
デフォルト:"50"
類似度。範囲:1〜100
integer
デフォルト:"50"
詳細度。範囲:1〜100
string
デフォルト:"AUTO"
プロンプト強化オプション。利用可能なパラメータ:AUTO、ON、OFF
integer
デフォルト:"1"
生成数。範囲:1〜8
integer
ランダムシード。範囲:0〜2147483647
file
必須
元の画像ファイル。JPEG、PNG、WebP形式をサポート

呼び出し例

Response

画像が正常に生成されました。

エラーコード

  • 400 : 画像拡大リクエストの不正なリクエストエラー
  • 401 : 画像拡大リクエストの認証エラー
  • 422 : 画像拡大リクエストの処理不能エンティティエラー
  • 429 : 画像拡大リクエストの多すぎるリクエストエラー

Describe

POST https://aihubmix.com/ideogram/describe アップロードされた画像を記述分析します。サポートされている画像形式はJPEG、PNG、WebPです。 リクエストパラメータ
file
必須
記述が必要な画像ファイル。JPEG、PNG、WebP形式をサポート

呼び出し例

Response

記述が正常に作成されました。

エラーコード

  • 400 : 記述リクエストの不正なリクエストエラー
  • 422 : 記述リクエストの処理不能エンティティエラー
  • 429 : 記述リクエストの多すぎるリクエストエラー

💰 V2 & V1 料金

画像生成

画像編集

画像強化

詳細については公式ドキュメントをご覧ください。

最終更新日:2026-06-01