Skip to main content
Endpoint: POST https://fal.run/fal-ai/ideogram/v2a/remix Endpoint ID: fal-ai/ideogram/v2a/remix

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/ideogram/v2a/remix",
    arguments={
        "prompt": "An ice field in north atlantic",
        "image_url": "https://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Capabilities

  • Text prompt input
  • Image input
  • Aspect ratio control
  • Strength control
  • Reproducible generation (seed)
  • Synchronous mode

​
API Reference

​
Input Schema

​
prompt
string
required
The prompt to remix the image with
​
image_url
string
required
The image URL to remix
​
aspect_ratio
AspectRatioEnum
default:"1:1"
The aspect ratio of the generated image Default value: "1:1"Possible values: 10:16, 16:10, 9:16, 16:9, 4:3, 3:4, 1:1, 1:3, 3:1, 3:2, 2:3
​
strength
float
default:"0.8"
Strength of the input image in the remix Default value: 0.8Range: 0.01 to 1
​
expand_prompt
boolean
default:"true"
Whether to expand the prompt with MagicPrompt functionality. Default value: true
​
seed
integer
Seed for the random number generator
​
style
StyleEnum
default:"auto"
The style of the generated image Default value: "auto"Possible values: auto, general, realistic, design, render_3D, anime
​
sync_mode
boolean
default:"false"
If True, the media will be returned as a data URI and the output data won’t be available in the request history.

​
Output Schema

​
images
list<File>
required
​
seed
integer
required
Seed used for the random number generator

​
Input Example

{
  "prompt": "An ice field in north atlantic",
  "image_url": "https://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png",
  "aspect_ratio": "1:1",
  "strength": 0.8,
  "expand_prompt": true,
  "style": "auto",
  "sync_mode": false
}

​
Output Example

{
  "images": [
    {
      "url": "https://fal.media/files/monkey/cNaoxPl0YAWYb-QVBvO9F_image.png"
    }
  ],
  "seed": 123456
}

​
Limitations

  • strength range: 0.01 to 1
  • style restricted to: auto, general, realistic, design, render_3D, anime