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)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/gpt-image-1.5", {
  input: {
      prompt: "create a realistic image taken with iphone at these coordinates 41°43′32″N 49°56′49″W 15 April 1912"
    },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/fal-ai/gpt-image-1.5 \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "create a realistic image taken with iphone at these coordinates 41°43′32″N 49°56′49″W 15 April 1912"
}'

Input Schema

string

required

The prompt for image generation

ImageSizeEnum

default:"1024x1024"

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

BackgroundEnum

default:"auto"

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

QualityEnum

default:"high"

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

integer

default:"1"

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

OutputFormatEnum

default:"png"

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

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

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)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/gpt-image-1.5/edit", {
  input: {
      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"
      ]
    },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/fal-ai/gpt-image-1.5/edit \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "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"
  ]
}'

Input Schema

string

required

The prompt for image generation

list<string>

required

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

ImageSizeEnum

default:"auto"

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

BackgroundEnum

default:"auto"

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

QualityEnum

default:"high"

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

InputFidelityEnum

default:"high"

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

integer

default:"1"

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

OutputFormatEnum

default:"png"

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

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.

string

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

Output Schema

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

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