Image

Ideogram Custom Models

Credit-based pricing. Supports batch up to 4.

Try Ideogram Custom Models →Compare models

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, 1:2, 2:1, 4:5, 5:4

Resolution

1024

Max batch

Inputs

Batch up to 4 per request

Example prompt

A sleek premium coffee brand identity — a minimalist ceramic mug with a hand-painted indigo wave pattern on a white surface, beside a small sprig of dried lavender and a kraft paper coffee bag with a custom logo seal stamped in gold foil, soft diffused studio lighting, elegant product photography, photorealistic

Try 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/custom-models/generate.

POST/api/v1/generate15 fields · 3 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.
`expand_prompt`	boolean	Optional	Whether to expand the prompt with MagicPrompt functionality. · Default: true
`seed`	integer	Optional	Seed for the random number generator.
`negative_prompt`	string	Optional	Description of what to exclude from the image. Descriptions in the prompt take precedence over descriptions in the negative prompt. · Default:
`custom_model_id`	string	Required	The id of a trained custom model returned by /train. The model must have finished training (status COMPLETED).
`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, 1:2, 2:1, 4:5, 5:4
`resolution`	string	Optional	Allowed: 1024
`quality`	string	Optional	Allowed: low, medium, high
`num_images`	integer	Optional	Range: 1–4

Minimal request example

{
  "model_id": "fal-ai/ideogram/custom-models/generate",
  "prompt": "A sleek premium coffee brand identity — a minimalist ceramic mug with a hand-painted indigo wave pattern on a white surface, beside a small sprig of dried lavender and a kraft paper coffee bag with a custom logo seal stamped in gold foil, soft diffused studio lighting, elegant product photography, photorealistic",
  "custom_model_id": "your_custom_model_id"
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fcustom-models%2Fgenerate",
  "title": "Ideogram Custom Models generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/custom-models/generate.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/ideogram/custom-models/generate",
      "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"
    },
    "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"
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "Description of what to exclude from the image. Descriptions in the prompt take precedence over descriptions in the negative prompt.",
      "default": "",
      "type": "string"
    },
    "custom_model_id": {
      "title": "Model Id",
      "description": "The id of a trained custom model returned by /train. The model must have finished training (status COMPLETED).",
      "type": "string"
    },
    "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",
        "1:2",
        "2:1",
        "4:5",
        "5:4"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024"
      ]
    },
    "quality": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    }
  },
  "required": [
    "model_id",
    "prompt",
    "custom_model_id"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Ideogram Custom Models 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 Custom Models fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Ideogram Custom Models from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/ideogram/custom-models/generate". 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 Custom Models?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.