Ideogram 4.0 Serverless API
Generate 2K posters and logos with accurate text rendering.
1import requests
2import json
3
4url = "https://api.segmind.com/v1/ideogram-4"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "prompt": "A vintage-style travel poster of Tokyo at night, glowing neon signs reflecting on wet streets, a bold title reading \"TOKYO\" across the top and the tagline \"Where Tradition Meets Tomorrow\" below, vibrant teal and magenta palette, clean retro print design",
12 "rendering_speed": "QUALITY",
13 "image_size": "square_hd",
14 "num_images": 1,
15 "enable_prompt_expansion": true,
16 "output_format": "jpeg",
17 "seed": 123456,
18 "enable_safety_checker": true
19}
20
21response = requests.post(url, headers=headers, json=data)
22
23if response.status_code == 200:
24 result = response.json()
25 print(json.dumps(result, indent=2))
26else:
27 print(f"Error: {response.status_code}")
28 print(response.text) 1import requests
2import json
3
4url = "https://api.segmind.com/v1/ideogram-4"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "prompt": "A vintage-style travel poster of Tokyo at night, glowing neon signs reflecting on wet streets, a bold title reading \"TOKYO\" across the top and the tagline \"Where Tradition Meets Tomorrow\" below, vibrant teal and magenta palette, clean retro print design",
12 "rendering_speed": "QUALITY",
13 "image_size": "square_hd",
14 "num_images": 1,
15 "enable_prompt_expansion": true,
16 "output_format": "jpeg",
17 "seed": 123456,
18 "enable_safety_checker": true
19}
20
21response = requests.post(url, headers=headers, json=data)
22
23if response.status_code == 200:
24 result = response.json()
25 print(json.dumps(result, indent=2))
26else:
27 print(f"Error: {response.status_code}")
28 print(response.text)API Endpoint
https://api.segmind.com/v1/ideogram-4Parameters
promptrequiredstringDescribe the image; put exact in-image text in quotes. More detail improves design and typography.
"A vintage-style travel poster of Tokyo at night, glowing neon signs reflecting on wet streets, a bold title reading \"TOKYO\" across the top and the tagline \"Where Tradition Meets Tomorrow\" below, vibrant teal and magenta palette, clean retro print design"enable_prompt_expansionoptionalbooleanLLM expands your prompt for richer detail. Disable when exact in-image text must stay unchanged.
trueenable_safety_checkeroptionalbooleanFilters unsafe content from outputs. Keep enabled for production and public-facing apps.
trueimage_sizeoptionalstringOutput aspect ratio and resolution. Portrait suits posters, landscape banners, square_hd is default.
"square_hd""square_hd""square""portrait_4_3""portrait_16_9""landscape_4_3""landscape_16_9"num_imagesoptionalintegerImages generated per request, 1 to 8. Raise to compare variations in one call.
1Range: 1 - 8output_formatoptionalstringImage file format. jpeg for smaller files, png for transparency and crisp text edges.
"jpeg""jpeg""png"rendering_speedoptionalstringSpeed/quality tradeoff. Use QUALITY for text-heavy design, TURBO for fast cheap drafts.
"QUALITY""TURBO""BALANCED""QUALITY"seedoptionalintegerRandom seed; -1 randomizes. Fix a value to reproduce the same image across runs.
123456Range: 100 - 999999Response Type
Returns: Text/JSON
Common Error Codes
The API returns standard HTTP status codes. Detailed error messages are provided in the response body.
Bad Request
Invalid parameters or request format
Unauthorized
Missing or invalid API key
Forbidden
Insufficient permissions
Not Found
Model or endpoint not found
Insufficient Credits
Not enough credits to process request
Rate Limited
Too many requests
Server Error
Internal server error
Bad Gateway
Service temporarily unavailable
Timeout
Request timed out