Generate（Text-to-image）

POST

/ideogram/generate

Text-to-image generation from Ideogram, with the advantage of producing accurate text and posters
Official documentation: https://api-docs.ideogram.ai/reference/post_generate_image

Pricing:
Ideogram 2A - 0.04 PTC/request
Ideogram 2A Turbo - 0.025 PTC/request
Ideogram 2.0 - 0.08 PTC/request
Ideogram 2.0 Turbo - 0.05 PTC/request
Ideogram 1.0 - 0.06 PTC/request
Ideogram 1.0 Turbo - 0.02 PTC/request

Request

Header Params

Body Params application/json

Example

{
  "image_request": {
    "model": "V_2",
    "magic_prompt_option": "AUTO",
    "aspect_ratio": "ASPECT_1_1",
    "prompt": "a dog",
    "style_type": "REALISTIC",
    "negative_prompt": "painting",
    "seed": 12345
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/ideogram/generate' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "image_request": {
    "model": "V_2",
    "magic_prompt_option": "AUTO",
    "aspect_ratio": "ASPECT_1_1",
    "prompt": "a dog",
    "style_type": "REALISTIC",
    "negative_prompt": "painting",
    "seed": 12345
  }
}'

Responses

🟢200成功

application/json

Body

Example

{
    "created": "2025-04-18T03:33:36.406137+00:00",
    "data": [
        {
            "is_image_safe": true,
            "prompt": "A photo of a golden retriever dog playing fetch in a field. The dog is running with a stick in its mouth. The background is a vast green field with a few trees. The sky is clear with a few clouds.",
            "resolution": "1024x1024",
            "seed": 12345,
            "url": "https://file.302.ai/gpt/imgs/20250418/53b334a66f4746b1b5facf73d8339659.png"
        }
    ]
}

Modified at 2026-01-13 07:09:33

Generate（Text-to-image V3）

Recraft-V3（Text to Image）