Fast iteration
Validate prompts in Playground before wiring createTask into your app.
IDEOGRAM
Ideogram Character
Commercial use30 credits / job
Try in Playground
Validate prompts and parameters before integration — same model and payload as production.
Request parameters
createTask input fields for the default tab.
| Field | Type | Required |
|---|---|---|
| prompt | textarea | Yes |
| aspect_ratio | select (1:1 | 16:9 | 9:16) | No |
Output examples
Typical generation previews (actual output varies by prompt).
Preview
Performance benefits
Why teams choose this model for production workloads.
Features
Core capabilities for this model on the ModKie gateway.
Production text-to-image
Submit prompt and aspect ratio via createTask; poll recordInfo for image URLs.
Playground validation
Debug prompts in-browser before copying JSON to production.
What you can build
Common developer and product use cases for this API.
Marketing creatives
Generate ad stills, hero images, and social assets from text prompts.
Pricing
Credits apply per successful job only.
Ideogram Character
30 credits / job
≈ $29.70 USD ($0.99 USD/credit Starter pack estimate)
Quickstart
Three steps from API key to your first successful job.
- 1
Create an API key
Sign in and create a key under Settings → API Keys.
- 2
Submit createTask
POST to /api/v1/jobs/createTask with your model id and input payload.
- 3
Poll recordInfo
Poll recordInfo until the job completes; download outputs from the response.
Example createTask request
curl -X POST https://modkie.com/api/v1/jobs/createTask \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram/character",
"input": {
"prompt": "Photorealistic portrait in soft window light, shallow depth of field, natural skin texture, 35mm photograph.",
"aspect_ratio": "16:9"
}
}'Poll GET /api/v1/jobs/recordInfo?taskId=… until state is success or fail. Credits apply only on success.
FAQ
Why ModKie for this model
ModKie is more than API relay — deploy, fine-tune, and register custom endpoints on the same gateway.
Unified gateway
One API key and jobs contract across marketplace and self-hosted models.
Playground
Validate payloads in-browser before shipping to production.
RunPod self-host
Deploy HuggingFace or custom workers and route traffic through ModKie.
Train & register
Fine-tune vision models and register weights back into the gateway.
Deployment help
Work with our team on model landing, integration, and production rollout.
Who it's for
- Developers — Ship features fast with Playground, docs, and predictable async billing.
- Enterprise teams — Standardize providers behind one contract, usage dashboard, and webhooks.
- Fine-tune & own weights — Train custom models and expose them with the same createTask flow.