Ideogram Character API
Generate consistent characters from a single reference image in many styles. Integrate this model via REST with endpoint docs, parameters, and code examples.
Get API Key
Create auth keys for apps and agents
See Usage
Track requests, credits, and logs
Buy Credits
Top up prepaid API capacity
Try a preset
Pre-tuned starting points. Click one to open the tool with these params loaded.
Book cover
Literary fiction book cover with bold title typography.
Try this preset
Event poster
Concert / festival poster with custom display type and date.
Try this preset
Magazine cover with title
Magazine cover composition with sharp legible cover lines.
Try this preset
Product with copy
Editorial product shot with sharp legible headline overlay.
Try this preset
Social quote card
Instagram-shareable quote card with elegant typography.
Try this preset
Storefront signage
Vintage storefront with a custom shop name on the awning.
Try this preset
API Endpoint
/api/v1/models/ideogram-character/runLLM.txt
For AI assistants
Copy this model's documentation into Claude, GPT, or any AI for instant integration help.
/llm/ideogram-character.txtOpenAPI Spec
Swagger compatible
Import into Postman, Swagger UI, or generate client SDKs in any language.
/api/openapiParameters
Input parameters accepted by this model
| Parameter | Type | Default |
|---|---|---|
promptrequired | string | - |
character_reference_imagerequired | url | - |
rendering_speed | enum | Default |
style_type | enum | - |
aspect_ratio | enum | - |
resolution | enum | - |
magic_prompt_option | enum | - |
seed | number | - |
numberOfImages | integer | 1 |
Example Outputs
Real outputs generated by this model
instagram-shareable quote card with elegant serif typography reading a short inspirational quote, soft warm gradient background, minimal composition, premium social media design
magazine cover composition with sharp legible cover lines reading "FUTURE WORK" in bold serif, secondary lines below, subject occupies the right two-thirds, editorial photography
concert festival poster, custom display typography reading "MIDNIGHT FESTIVAL · OCT 24", layered visual elements, retro 70s aesthetic with modern typography
literary fiction book cover, bold title "The Last Architect" set in elegant serif, author name below, atmospheric photography behind, premium hardcover quality
vintage storefront with a custom shop name "BAKER & SONS" hand-painted on the awning, warm afternoon light, photorealistic
editorial product shot with sharp legible headline overlay reading "NEW SEASON", bold serif typography, magazine cover composition
a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."
a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."
a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."
Code Examples
Copy and paste to get started
curl -X POST "https://pixeldojo.ai/api/v1/models/ideogram-character/run" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A beautiful mountain landscape at golden hour",
"aspect_ratio": "1:1"
}'Response Format
Submit Response (202 Accepted)
{
"jobId": "job_abc123...",
"status": "pending",
"statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
"creditCost": 5,
"creditsRemaining": 95,
"expiresAt": "2025-01-23T12:00:00Z"
}Completed Response
{
"jobId": "job_abc123...",
"status": "completed",
"output": {
"images": [
"https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
]
},
"creditCost": 5,
"expiresAt": "2025-01-23T12:00:00Z"
}