text-to-image

Create image from text - Ideogram 4

Generate images from text with Ideogram 4.

Key Features:

  • Accurate text rendering for posters, logos and typography
  • 15 aspect ratios, from 3:1 to 1:3, always at about 4 megapixels
  • Optional negative prompt, Magic Prompt control and seed

Best for:

  • Posters, flyers and social graphics with legible text
  • Logos and typographic designs

Credits: the price is set by rendering_speed (TURBO, DEFAULT or QUALITY). The other parameters do not affect it.

post/v1/ai/text-to-image/ideogram-4

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/text-to-image/ideogram-4
  • Auth: API key in header x-magnific-api-key

Request body

promptstring required

Text description of the image to generate. Ideogram 4 is especially good at rendering text: put the words to draw in quotes.

webhook_urlstring uri

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

negative_promptstring

What to leave out of the image. Descriptions in prompt take precedence over this field.

aspect_ratio'1:1' | '16:9' | '9:16' | '16:10' | '10:16' | '4:3' | '3:4' | '3:2' | '2:3' | '5:4' | '4:5' | '2:1' | '1:2' | '3:1' | '1:3'

Aspect ratio for the generated image. The output is always about 4 megapixels: 2048x2048 at 1:1, and the same area at the other ratios.

Available ratios:

  • 1:1: Square (default)
  • 16:9, 9:16: Widescreen/Social stories
  • 16:10, 10:16: Widescreen/Tall
  • 4:3, 3:4: Standard
  • 3:2, 2:3: Classic photo
  • 5:4, 4:5: Photo print
  • 2:1, 1:2, 3:1, 1:3: Banners and vertical panels
rendering_speed'TURBO' | 'DEFAULT' | 'QUALITY'

Quality tier. It sets the price of the generation.

Available tiers:

  • TURBO: Fastest and cheapest
  • DEFAULT: Balanced quality and speed (default)
  • QUALITY: Highest quality, slowest
magic_prompt'AUTO' | 'ON' | 'OFF'

Whether Ideogram's Magic Prompt rewrites the prompt into a more detailed one before generating. AUTO lets the model decide; use OFF to render the prompt verbatim. It does not affect the price.

seedinteger

Seed for reproducible results. When omitted, a random seed is used.

Example request

{
  "prompt": "A vintage travel poster of a lighthouse at dusk with the text \"Ideogram 4\" in bold art deco letters",
  "webhook_url": "https://www.example.com/webhook",
  "negative_prompt": "blurry, low contrast",
  "aspect_ratio": "1:1",
  "rendering_speed": "DEFAULT",
  "magic_prompt": "AUTO",
  "seed": 42
}

Response

OK - The request has succeeded and the Ideogram 4 process has started.

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.