Gpt Image 1.5 API

Gpt Image 1.5
Edit

Endpoint: POST https://fal.run/fal-ai/gpt-image-1.5 Endpoint ID: fal-ai/gpt-image-1.5

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/gpt-image-1.5",
    arguments={
        "prompt": "create a realistic image taken with iphone at these coordinates 41°43′32″N 49°56′49″W 15 April 1912"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

Input Schema

prompt

string

required

The prompt for image generation

image_size

ImageSizeEnum

default:"1024x1024"

Aspect ratio for the generated image Default value: "1024x1024"Possible values: 1024x1024, 1536x1024, 1024x1536

background

BackgroundEnum

default:"auto"

Background for the generated image Default value: "auto"Possible values: auto, transparent, opaque

quality

QualityEnum

default:"high"

Quality for the generated image Default value: "high"Possible values: low, medium, high

num_images

integer

default:"1"

Number of images to generate Default value: 1Range: 1 to 4

output_format

OutputFormatEnum

default:"png"

Output format for the images Default value: "png"Possible values: jpeg, png, webp

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<ImageFile>

required

The generated images.

Input Example

{
  "prompt": "create a realistic image taken with iphone at these coordinates 41°43′32″N 49°56′49″W 15 April 1912",
  "image_size": "1024x1024",
  "background": "auto",
  "quality": "high",
  "num_images": 1,
  "output_format": "png",
  "sync_mode": false
}

Output Example

{
  "images": [
    {
      "content_type": "image/png",
      "file_name": "EnWrO3XWjPE0nxBDpaQrj.png",
      "height": 1024,
      "url": "https://v3b.fal.media/files/b/0a869129/EnWrO3XWjPE0nxBDpaQrj.png",
      "width": 1024
    }
  ]
}

Endpoint: POST https://fal.run/fal-ai/gpt-image-1.5/edit Endpoint ID: fal-ai/gpt-image-1.5/edit

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/gpt-image-1.5/edit",
    arguments={
        "prompt": "Same workers, same beam, same lunch boxes - but they're all on their phones now. One is taking a selfie. One is on a call looking annoyed. Same danger, new priorities. A hard hat has AirPods.",
        "image_urls": [
            "https://v3b.fal.media/files/b/0a8691af/9Se_1_VX1wzTjjTOpWbs9_bb39c2eb-1a41-4749-b1d0-cf134abc8bbf.png"
        ]
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

Input Schema

prompt

string

required

The prompt for image generation

image_urls

list<string>

required

The URLs of the images to use as a reference for the generation.

image_size

ImageSizeEnum

default:"auto"

Aspect ratio for the generated image Default value: "auto"Possible values: auto, 1024x1024, 1536x1024, 1024x1536

background

BackgroundEnum

default:"auto"

Background for the generated image Default value: "auto"Possible values: auto, transparent, opaque

quality

QualityEnum

default:"high"

Quality for the generated image Default value: "high"Possible values: low, medium, high

input_fidelity

InputFidelityEnum

default:"high"

Input fidelity for the generated image Default value: "high"Possible values: low, high

num_images

integer

default:"1"

Number of images to generate Default value: 1Range: 1 to 4

output_format

OutputFormatEnum

default:"png"

Output format for the images Default value: "png"Possible values: jpeg, png, webp

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.

mask_image_url

string

The URL of the mask image to use for the generation. This indicates what part of the image to edit.

Output Schema

images

list<ImageFile>

required

The generated images.

Input Example

{
  "prompt": "Same workers, same beam, same lunch boxes - but they're all on their phones now. One is taking a selfie. One is on a call looking annoyed. Same danger, new priorities. A hard hat has AirPods.",
  "image_urls": [
    "https://v3b.fal.media/files/b/0a8691af/9Se_1_VX1wzTjjTOpWbs9_bb39c2eb-1a41-4749-b1d0-cf134abc8bbf.png"
  ],
  "image_size": "auto",
  "background": "auto",
  "quality": "high",
  "input_fidelity": "high",
  "num_images": 1,
  "output_format": "png",
  "sync_mode": false
}

Output Example

{
  "images": [
    {
      "content_type": "image/png",
      "file_name": "yUt7tifLSbg1WzWWgfj2o.png",
      "height": 1024,
      "url": "https://v3b.fal.media/files/b/0a8691b0/yUt7tifLSbg1WzWWgfj2o.png",
      "width": 1024
    }
  ]
}

GPT-Image 1.5 — Image Generation

Limitations

image_size restricted to: 1024x1024, 1536x1024, 1024x1536
background restricted to: auto, transparent, opaque
quality restricted to: low, medium, high
num_images range: 1 to 4
output_format restricted to: jpeg, png, webp
image_size restricted to: auto, 1024x1024, 1536x1024, 1024x1536
input_fidelity restricted to: low, high

Video Generation

Image Generation

Audio

Vision

3D

Gpt Image 1.5 API

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Limitations

Video Generation

Image Generation

Audio

Vision

3D

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

​Related

​Limitations

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Related

Limitations