Generate 3.0 (Text-to-Image) Generate

POST

/ideogram/v1/ideogram-v3/generate

• Generates images synchronously using the Ideogram 3.0 model based on the given prompt and optional parameters
• Returned image URLs are valid for 24 hours, after which they become inaccessible
• Images are proxied
• Official documentation: Generate 3.0 API

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Prompt text required for image generation

Random seed. Setting this value enables reproducible generation results

Minimum0

Maximum2147483647

Supported resolution options

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 for image generation, determines the image resolution. Cannot be used with the resolution parameter simultaneously. Defaults to 1x1

Valid values"1x3""3x1""1x2""2x1""9x16""16x9""10x16""16x10""2x3""3x2""3x4""4x3""4x5""5x4""1x1"

Rendering speed option

Valid values"TURBO""DEFAULT""QUALITY"

Default"DEFAULT"

Determines whether to use Magic Prompt when generating requests

Valid values"AUTO""ON""OFF"

Describes content to exclude from the image. Descriptions in the prompt take precedence over those in the negative prompt

Number of images to generate

Minimum1

Maximum8

Default1

object

Color palette for generation, must be explicitly specified via a preset (name) or via hex color representations with optional weights (members)

string[]

List of 8-character hexadecimal codes representing image styles. Cannot be used with style_reference_images or style_type

Style type to generate

Valid values"AUTO""GENERAL""REALISTIC""DESIGN"

Default"GENERAL"