
Output
image
Aspect ratio
1:1, 16:9, 9:16, 4:3, 3:4, 10:16, 16:10, 3:2, 2:3, 1:3, 3:1
Resolution
1024
Example prompt
A vibrant retro 1950s travel poster for a fictional oceanic space station called Neptune's Rest, bold art deco typography reading 'VISIT NEPTUNE'S REST — Where the Stars Meet the Sea', stylized illustration of a futuristic glass dome hotel with bioluminescent fish and cosmic nebulae visible through curved walls, rich teal and coral color palette, vintage halftone printing texture, collectible poster art, ultra detailedTry this prompt →
LLM-ready
API & LLM schema
Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/ideogram/v2.
POST
/api/v1/generate13 fields · 2 required| Field | Type | Requirement | Contract |
|---|---|---|---|
model_id | constant | Required | ArtEmotion model identifier. |
extra | object | Optional | Model-specific settings may also be nested here. |
max_credits | number | Optional | Reject before submission if the estimated list price exceeds this cap. · Range: 1–… |
webhook_url | string | Optional | Format: uri |
webhook_secret | string | Optional | Optional model input. |
folder_id | string | Optional | Optional model input. |
prompt | string | Required | Optional model input. |
negative_prompt | string | Optional | A negative prompt to avoid in the generated image · Default: |
style | string | Optional | The style of the generated image · Allowed: auto, general, realistic, design, render_3D, anime · Default: auto |
expand_prompt | boolean | Optional | Whether to expand the prompt with MagicPrompt functionality. · Default: true |
seed | integer | Optional | Seed for the random number generator |
aspect_ratio | string | Optional | Allowed: 1:1, 16:9, 9:16, 4:3, 3:4, 10:16, 16:10, 3:2, 2:3, 1:3, 3:1 |
resolution | string | Optional | Allowed: 1024 |
Minimal request example
{
"model_id": "fal-ai/ideogram/v2",
"prompt": "A vibrant retro 1950s travel poster for a fictional oceanic space station called Neptune's Rest, bold art deco typography reading 'VISIT NEPTUNE'S REST — Where the Stars Meet the Sea', stylized illustration of a futuristic glass dome hotel with bioluminescent fish and cosmic nebulae visible through curved walls, rich teal and coral color palette, vintage halftone printing texture, collectible poster art, ultra detailed"
}Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv2",
"title": "Ideogram v2 generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v2.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v2",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "A negative prompt to avoid in the generated image",
"default": "",
"type": "string"
},
"style": {
"title": "Style",
"description": "The style of the generated image",
"default": "auto",
"type": "string",
"enum": [
"auto",
"general",
"realistic",
"design",
"render_3D",
"anime"
]
},
"expand_prompt": {
"title": "Expand Prompt",
"description": "Whether to expand the prompt with MagicPrompt functionality.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"10:16",
"16:10",
"3:2",
"2:3",
"1:3",
"3:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}FAQ
How much does Ideogram v2 cost on ArtEmotion?
Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.
Do I get my credits back if Ideogram v2 fails?
Yes — failed generations are never charged. The credits are released back to your balance automatically.
Can I call Ideogram v2 from the API?
Yes. Use POST /api/v1/generate with model_id: "fal-ai/ideogram/v2". See the API reference for the full schema.
Where are my generations stored?
Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.
Ready to generate with Ideogram v2?
Start now →No commitment. New accounts get 50 free credits on signup. See pricing.