Create image from text - Ideogram 4.5

curl --request POST \
  --url https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "Turn image 1 into a vintage travel poster with the text \"Ideogram 4.5\" in bold art deco letters",
  "webhook_url": "https://www.example.com/webhook",
  "images": [
    "https://example.com/source.png"
  ],
  "aspect_ratio": "auto",
  "quality": "medium",
  "magic_prompt": "auto",
  "seed": 42
}
'

import requests

url = "https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5"

payload = {
    "prompt": "Turn image 1 into a vintage travel poster with the text \"Ideogram 4.5\" in bold art deco letters",
    "webhook_url": "https://www.example.com/webhook",
    "images": ["https://example.com/source.png"],
    "aspect_ratio": "auto",
    "quality": "medium",
    "magic_prompt": "auto",
    "seed": 42
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'Turn image 1 into a vintage travel poster with the text "Ideogram 4.5" in bold art deco letters',
    webhook_url: 'https://www.example.com/webhook',
    images: ['https://example.com/source.png'],
    aspect_ratio: 'auto',
    quality: 'medium',
    magic_prompt: 'auto',
    seed: 42
  })
};

fetch('https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'Turn image 1 into a vintage travel poster with the text "Ideogram 4.5" in bold art deco letters',
    'webhook_url' => 'https://www.example.com/webhook',
    'images' => [
        'https://example.com/source.png'
    ],
    'aspect_ratio' => 'auto',
    'quality' => 'medium',
    'magic_prompt' => 'auto',
    'seed' => 42
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5"

	payload := strings.NewReader("{\n  \"prompt\": \"Turn image 1 into a vintage travel poster with the text \\\"Ideogram 4.5\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"auto\",\n  \"quality\": \"medium\",\n  \"magic_prompt\": \"auto\",\n  \"seed\": 42\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-magnific-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"Turn image 1 into a vintage travel poster with the text \\\"Ideogram 4.5\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"auto\",\n  \"quality\": \"medium\",\n  \"magic_prompt\": \"auto\",\n  \"seed\": 42\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"Turn image 1 into a vintage travel poster with the text \\\"Ideogram 4.5\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"auto\",\n  \"quality\": \"medium\",\n  \"magic_prompt\": \"auto\",\n  \"seed\": 42\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Ideogram 4.5

Create Image

Generate or edit images with Ideogram 4.5.

Key Features:

Text-to-image and image editing in the same endpoint: send up to 5 images; the first one is edited and the rest guide the edit
Accurate text rendering for posters, logos and typography
13 aspect ratios at about 4 megapixels, plus auto to follow the input image

Best for:

Designs with legible text, from scratch or from an existing image
Instruction-based edits of an image guided by references

Credits: the price is set by quality (very_low, low, medium or high). The other parameters do not affect it. very_low is only available when images are sent.

POST

text-to-image

ideogram-4-5

Create image from text - Ideogram 4.5

curl --request POST \
  --url https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "Turn image 1 into a vintage travel poster with the text \"Ideogram 4.5\" in bold art deco letters",
  "webhook_url": "https://www.example.com/webhook",
  "images": [
    "https://example.com/source.png"
  ],
  "aspect_ratio": "auto",
  "quality": "medium",
  "magic_prompt": "auto",
  "seed": 42
}
'

import requests

url = "https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5"

payload = {
    "prompt": "Turn image 1 into a vintage travel poster with the text \"Ideogram 4.5\" in bold art deco letters",
    "webhook_url": "https://www.example.com/webhook",
    "images": ["https://example.com/source.png"],
    "aspect_ratio": "auto",
    "quality": "medium",
    "magic_prompt": "auto",
    "seed": 42
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'Turn image 1 into a vintage travel poster with the text "Ideogram 4.5" in bold art deco letters',
    webhook_url: 'https://www.example.com/webhook',
    images: ['https://example.com/source.png'],
    aspect_ratio: 'auto',
    quality: 'medium',
    magic_prompt: 'auto',
    seed: 42
  })
};

fetch('https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'Turn image 1 into a vintage travel poster with the text "Ideogram 4.5" in bold art deco letters',
    'webhook_url' => 'https://www.example.com/webhook',
    'images' => [
        'https://example.com/source.png'
    ],
    'aspect_ratio' => 'auto',
    'quality' => 'medium',
    'magic_prompt' => 'auto',
    'seed' => 42
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5"

	payload := strings.NewReader("{\n  \"prompt\": \"Turn image 1 into a vintage travel poster with the text \\\"Ideogram 4.5\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"auto\",\n  \"quality\": \"medium\",\n  \"magic_prompt\": \"auto\",\n  \"seed\": 42\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-magnific-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"Turn image 1 into a vintage travel poster with the text \\\"Ideogram 4.5\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"auto\",\n  \"quality\": \"medium\",\n  \"magic_prompt\": \"auto\",\n  \"seed\": 42\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/text-to-image/ideogram-4-5")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"Turn image 1 into a vintage travel poster with the text \\\"Ideogram 4.5\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"images\": [\n    \"https://example.com/source.png\"\n  ],\n  \"aspect_ratio\": \"auto\",\n  \"quality\": \"medium\",\n  \"magic_prompt\": \"auto\",\n  \"seed\": 42\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Authorizations

x-magnific-api-key

string

header

required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json

prompt

string

required

Text description of the image to generate, or of the edit to apply. When images are sent, refer to them by position: "image 1" is the first one (the image being edited) and "image 2" onwards are the references.

Required string length: 1 - 10000

Example:

"Turn image 1 into a vintage travel poster with the text \"Ideogram 4.5\" in bold art deco letters"

webhook_url

string<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.

Example:

"https://www.example.com/webhook"

images

string[]

Optional input images. Without them the request is text-to-image. With them, the first image is the one being edited and the rest guide the edit as references.

Image requirements:

Maximum 5 images
Supported formats: PNG, JPEG, WebP
Aspect ratio between 1:6 and 6:1
Public HTTPS URL or base64-encoded string

Required array length: 1 - 5 elements

Example:

["https://example.com/source.png"]

aspect_ratio

enum<string>

default:auto

Aspect ratio for the generated image, on a canvas of about 4 megapixels.

Available ratios:

auto: Let the model choose (default). With images it follows the first image; without them it picks the canvas that best fits the prompt.
1:1: Square, 2048x2048
4:5, 5:4: Photo print
3:4, 4:3: Standard
2:3, 3:2: Classic photo
9:16, 16:9: Social stories/Widescreen
1:2, 2:1, 1:3, 3:1: Banners and vertical panels

Available options:

auto,

1:1,

4:5,

5:4,

3:4,

4:3,

2:3,

3:2,

9:16,

16:9,

1:2,

2:1,

1:3,

3:1

Example:

"auto"

quality

enum<string>

default:medium

Quality tier. It sets the price of the generation.

Available tiers:

very_low: Cheapest and fastest. Only available when images are sent (editing); a text-only request with it is rejected.
low
medium: Default
high: Best quality, slowest

Available options:

very_low,

low,

medium,

high

Example:

"medium"

magic_prompt

enum<string>

default:auto

Whether Ideogram's Magic Prompt rewrites the prompt into a more detailed one before generating. auto lets the model decide; use off for verbatim edit instructions. It does not affect the price.

Available options:

auto,

on,

off

Example:

"auto"

seed

integer

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

Required range: 0 <= x <= 2147483647

Example:

42

Response

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

data

object

required

Show child attributes

Example:

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

Get started

APIs

Create Image

Authorizations

Body

Response