Image

Ideogram v2 (Edit)

Credit-based pricing. Supports reference images.

Try Ideogram v2 (Edit) →Compare models

Output

image

Aspect ratio

1:1, 16:9, 9:16, 4:3, 3:4

Resolution

1024

Inputs

Reference image (required)

Example prompt

Transform this ramen bowl into an otherworldly cosmic noodle soup — the broth glows with swirling nebula colors of deep purple and teal, star-shaped dumplings float in the soup, the bowl is made of polished obsidian with golden constellations etched around the rim, chopsticks made of glowing crystal, served on a floating asteroid in deep space

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/v2/edit.

POST/api/v1/generate14 fields · 4 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.
`seed`	integer	Optional	Seed for the random number generator
`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
`mask_url`	string	Required	Handled by the canvas mask editor.
`aspect_ratio`	string	Optional	Allowed: 1:1, 16:9, 9:16, 4:3, 3:4
`resolution`	string	Optional	Allowed: 1024
`reference_image_url`	string	Required	Format: uri

Minimal request example

{
  "model_id": "fal-ai/ideogram/v2/edit",
  "prompt": "Transform this ramen bowl into an otherworldly cosmic noodle soup — the broth glows with swirling nebula colors of deep purple and teal, star-shaped dumplings float in the soup, the bowl is made of polished obsidian with golden constellations etched around the rim, chopsticks made of glowing crystal, served on a floating asteroid in deep space",
  "mask_url": "your_mask_url",
  "reference_image_url": "https://example.com/reference_image"
}

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%2Fedit",
  "title": "Ideogram v2 (Edit) generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v2/edit.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/ideogram/v2/edit",
      "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"
    },
    "seed": {
      "title": "Seed",
      "description": "Seed for the random number generator",
      "type": "integer"
    },
    "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"
    },
    "mask_url": {
      "title": "Mask Url",
      "description": "Handled by the canvas mask editor.",
      "type": "string"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024"
      ]
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "mask_url",
    "reference_image_url"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Ideogram v2 (Edit) 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 (Edit) fails?

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

Can I call Ideogram v2 (Edit) from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/ideogram/v2/edit". 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 (Edit)?

Start now →

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