Generate 3.0(テキストから画像生成)Generate
POST
/ideogram/v1/ideogram-v3/generate
- Ideogram 3.0 モデルを使用して、指定されたプロンプトとオプションパラメータに基づき画像を同期生成します
- 返された画像 URL は 24 時間有効で、その期間を過ぎるとアクセスできなくなります
- 画像はプロキシ経由で配信されます
- 公式ドキュメント: Generate 3.0 API
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
prompt
string
Required
画像生成に必要なプロンプトテキスト
seed
integer
ランダムシード。この値を設定すると再現性のある生成結果が得られます
Minimum
0Maximum
2147483647resolution
string
サポートされている解像度オプション
Valid values
"512x1536""576x1408""576x1472""576x1536""640x1344""640x1408""640x1472""640x1536""704x1152""704x1216""704x1280""704x1344""704x1408""704x1472""736x1312""768x1088""768x1216""768x1280""768x1344""800x1280""832x960""832x1024""832x1088""832x1152""832x1216""832x1248""864x1152""896x960""896x1024""896x1088""896x1120""896x1152""960x832""960x896""960x1024""960x1088""1024x832""1024x896""1024x960""1024x1024""1088x768""1088x832""1088x896""1088x960""1120x896""1152x704""1152x832""1152x864""1152x896""1216x704""1216x768""1216x832""1248x832""1280x704""1280x768""1280x800""1312x736""1344x640""1344x704""1344x768""1408x576""1408x640""1408x704""1472x576""1472x640""1472x704""1536x512""1536x576""1536x640"aspect_ratio
string
画像生成のアスペクト比。画像の解像度を決定します。resolution パラメータとは同時に使用できません。デフォルトは 1x1
Valid values
"1x3""3x1""1x2""2x1""9x16""16x9""10x16""16x10""2x3""3x2""3x4""4x3""4x5""5x4""1x1"rendering_speed
string
レンダリング速度オプション
Valid values
"TURBO""DEFAULT""QUALITY"Default
"DEFAULT"magic_prompt
string
リクエスト生成時に Magic Prompt を使用するかどうかを決定します
Valid values
"AUTO""ON""OFF"negative_prompt
string
画像から除外する内容を記述します。プロンプト内の説明がネガティブプロンプト内の説明より優先されます
num_images
integer
生成する画像の数
Minimum
1Maximum
8Default
1color_palette
object
生成用カラーパレット。プリセット(name)またはオプションの重み付きカラーの16進表現(members)で明示的に指定する必要があります
Expand
style_codes
string[]
画像スタイルを表す8文字の16進コードリスト。style_reference_images や style_type とは同時に使用できません
Expand
style_type
string
生成するスタイルタイプ
Valid values
"AUTO""GENERAL""REALISTIC""DESIGN"Default
"GENERAL"Responses
成功
application/json
object
code
integer
Required
message
string
Required
request_id
string
Required
data
object
Required