Ideogram Text To Image

Ideogram Text to Image: Turn your ideas into stunning visuals instantly with this powerful AI tool. Create captivating designs, realistic images, and more. Perfect for artists, designers, and anyone seeking creative inspiration.

~21.64s

$0.1 per generation

Playground API

Pricing

~21.64s

$0.1 per generation

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/ideogram-txt-2-img"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "magic_prompt_option": "AUTO",
12    "negative_prompt": "low quality,blurry",
13    "prompt": "A cinematic black and white medium shot of Albert Einstein in a lab. He is writing a text and looking at the blackboard. The text on the blackboard says 'Stay calm and use Segmind'. The background is filled with scientific equipment.",
14    "resolution": "RESOLUTION_1024_1024",
15    "seed": 56698,
16    "style_type": "GENERAL"
17}
18
19response = requests.post(url, headers=headers, json=data)
20
21if response.status_code == 200:
22    result = response.json()
23    print(json.dumps(result, indent=2))
24else:
25    print(f"Error: {response.status_code}")
26    print(response.text)

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/ideogram-txt-2-img"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "magic_prompt_option": "AUTO",
12    "negative_prompt": "low quality,blurry",
13    "prompt": "A cinematic black and white medium shot of Albert Einstein in a lab. He is writing a text and looking at the blackboard. The text on the blackboard says 'Stay calm and use Segmind'. The background is filled with scientific equipment.",
14    "resolution": "RESOLUTION_1024_1024",
15    "seed": 56698,
16    "style_type": "GENERAL"
17}
18
19response = requests.post(url, headers=headers, json=data)
20
21if response.status_code == 200:
22    result = response.json()
23    print(json.dumps(result, indent=2))
24else:
25    print(f"Error: {response.status_code}")
26    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/ideogram-txt-2-img

Parameters

promptrequired

string

Prompt to render

color_paletteoptional

any | any

A color palette for generation

One of:

Preset Color Paletteoptional

any

namerequired

string

Custom Color Paletteoptional

any

membersrequired

object[]

magic_prompt_optionoptional

string

Option for magic prompt

Default: "AUTO"

Allowed values :

"AUTO""ON""OFF"

negative_promptoptional

string

Negative prompt to avoid specific elements

resolutionoptional

string

Resolution of the output image

Default: "RESOLUTION_1024_1024"

Allowed values (78 total):

"RESOLUTION_512_1536""RESOLUTION_576_1408""RESOLUTION_576_1472""RESOLUTION_576_1536""RESOLUTION_640_1024""RESOLUTION_640_1344""RESOLUTION_640_1408""RESOLUTION_640_1472""RESOLUTION_640_1536""RESOLUTION_704_1152"+68 more

seedoptional

integer

Seed for random generation

Range: 100 - 999999

style_typeoptional

string

Style type for the output

Default: "GENERAL"

Allowed values :

"GENERAL""REALISTIC""DESIGN""RENDER_3D""ANIME"

Response Type

Returns: Text/JSON

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out