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
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
the same person sketching in a notebook on a park bench, autumn setting
the same person working on a laptop at a modern cafe, headphones, focused
the same person painting at an art studio easel, paint-splattered apron
the same person presenting at a tech meetup on a small stage, blazer
the same person among flowers at a botanical garden, sundress, sunny day
the same person jogging along a waterfront promenade in athletic wear, morning light
the same person as a chef in a restaurant kitchen, white chefs coat, focused
the same person reading by a fireplace in a cozy cabin, knit sweater, mug of tea
the same person riding a bicycle through a European old town, casual jacket
the same person choosing fresh vegetables at a farmers market, tote bag
the same person playing acoustic guitar on a rooftop at golden hour
the same person as a scientist in a bright laboratory, white lab coat, holding a glass flask
the same person browsing shelves in a cozy bookstore, cardigan, soft lighting
the same person teaching in front of a classroom whiteboard, friendly gesture
the same person studying at a university library, hoodie, surrounded by books
the same person fishing on a calm lake at dawn, flannel shirt and cap
the same person gardening in a sunny backyard, rolled-up sleeves, holding a potted plant
the same person giving a presentation in a conference room, smart casual attire
the same person on a beach at sunset in a light summer dress, ocean breeze
the same person walking through an autumn park in a scarf and wool coat, leaves falling
the same person cooking in a bright modern kitchen, wearing an apron, laughing
the same person in a tailored business suit in a modern office, confident pose
the same person sitting in a cozy coffee shop reading a book, warm afternoon light
the same person hiking on a sunny mountain trail, wearing a red windbreaker, wide smile
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"
}