Create image from text - Ideogram 4

curl --request POST \
  --url https://api.magnific.com/v1/ai/text-to-image/ideogram-4 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "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
}
'

import requests

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

payload = {
    "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
}
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: '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
  })
};

fetch('https://api.magnific.com/v1/ai/text-to-image/ideogram-4', 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",
  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' => '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
  ]),
  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"

	payload := strings.NewReader("{\n  \"prompt\": \"A vintage travel poster of a lighthouse at dusk with the text \\\"Ideogram 4\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"negative_prompt\": \"blurry, low contrast\",\n  \"aspect_ratio\": \"1:1\",\n  \"rendering_speed\": \"DEFAULT\",\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")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A vintage travel poster of a lighthouse at dusk with the text \\\"Ideogram 4\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"negative_prompt\": \"blurry, low contrast\",\n  \"aspect_ratio\": \"1:1\",\n  \"rendering_speed\": \"DEFAULT\",\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")

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\": \"A vintage travel poster of a lighthouse at dusk with the text \\\"Ideogram 4\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"negative_prompt\": \"blurry, low contrast\",\n  \"aspect_ratio\": \"1:1\",\n  \"rendering_speed\": \"DEFAULT\",\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

Create Image

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

text-to-image

ideogram-4

Create image from text - Ideogram 4

curl --request POST \
  --url https://api.magnific.com/v1/ai/text-to-image/ideogram-4 \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "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
}
'

import requests

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

payload = {
    "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
}
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: '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
  })
};

fetch('https://api.magnific.com/v1/ai/text-to-image/ideogram-4', 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",
  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' => '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
  ]),
  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"

	payload := strings.NewReader("{\n  \"prompt\": \"A vintage travel poster of a lighthouse at dusk with the text \\\"Ideogram 4\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"negative_prompt\": \"blurry, low contrast\",\n  \"aspect_ratio\": \"1:1\",\n  \"rendering_speed\": \"DEFAULT\",\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")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A vintage travel poster of a lighthouse at dusk with the text \\\"Ideogram 4\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"negative_prompt\": \"blurry, low contrast\",\n  \"aspect_ratio\": \"1:1\",\n  \"rendering_speed\": \"DEFAULT\",\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")

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\": \"A vintage travel poster of a lighthouse at dusk with the text \\\"Ideogram 4\\\" in bold art deco letters\",\n  \"webhook_url\": \"https://www.example.com/webhook\",\n  \"negative_prompt\": \"blurry, low contrast\",\n  \"aspect_ratio\": \"1:1\",\n  \"rendering_speed\": \"DEFAULT\",\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. Ideogram 4 is especially good at rendering text: put the words to draw in quotes.

Required string length: 1 - 10000

Example:

"A vintage travel poster of a lighthouse at dusk with the text \"Ideogram 4\" 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"

negative_prompt

string

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

Maximum string length: 2000

Example:

"blurry, low contrast"

aspect_ratio

enum<string>

default:1:1

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

Available options:

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

Example:

"1:1"

rendering_speed

enum<string>

default:DEFAULT

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

Available options:

TURBO,

DEFAULT,

QUALITY

Example:

"DEFAULT"

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 to render the prompt verbatim. 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 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