openai/gpt-image-1 | Run with an API on Replicate

openai / gpt-image-1

A multimodal image generation model that creates high-quality images. You need to bring your own verified OpenAI key to use this model. Your OpenAI account will be charged for usage.

Warm

Public
220.5K runs
$1 per thousand output images
Commercial use
Paper
License

Iterate in playground

Run with an API

Playground API Examples README

Input

openai_api_key

*secret

Your OpenAI API key

prompt

*string

Shift + Return to add a new line

A text description of the desired image

aspect_ratio

string

The aspect ratio of the generated image

Default: "1:1"

input_fidelity

string

Control how much effort the model will exert to match the style and features, especially facial features, of input images

Default: "low"

input_images

file[]

Add multiple files

https://replicate.delivery/pbxt/MusWuQJm1RJPu1Cj0ajRmoMnHyYNPk6ljT1QCU4DbHMsqDTF/53541851-62f3-44a7-b075-ef053ae2f324.jpg

https://replicate.delivery/pbxt/MusWuPkfcvyZQuuXeMIbQXEMe9K2G8rDCNraQffAt0OzMRaT/colored-flower-pattern-free-vector.jpg

A list of images to use as input for the generation

number_of_images

integer

(minimum: 1, maximum: 10)

Number of images to generate (1-10)

Default: 1

quality

string

The quality of the generated image

Default: "auto"

background

string

Set whether the background is transparent or opaque or choose automatically

Default: "auto"

output_compression

integer

(minimum: 0, maximum: 100)

Compression level (0-100%)

Default: 90

output_format

string

Output format

Default: "webp"

moderation

string

Content moderation level

Default: "auto"

user_id

string

Shift + Return to add a new line

An optional unique identifier representing your end-user. This helps OpenAI monitor and detect abuse.

Run this model in Node.js with one line of code:

npx create-replicate --model=openai/gpt-image-1

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";
import fs from "node:fs";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run openai/gpt-image-1 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const input = {
  prompt: "Add the floral pattern to the vase",
  quality: "auto",
  background: "auto",
  moderation: "auto",
  aspect_ratio: "1:1",
  input_images: ["https://replicate.delivery/pbxt/MusWuQJm1RJPu1Cj0ajRmoMnHyYNPk6ljT1QCU4DbHMsqDTF/53541851-62f3-44a7-b075-ef053ae2f324.jpg","https://replicate.delivery/pbxt/MusWuPkfcvyZQuuXeMIbQXEMe9K2G8rDCNraQffAt0OzMRaT/colored-flower-pattern-free-vector.jpg"],
  output_format: "webp",
  input_fidelity: "low",
  openai_api_key: "",
  number_of_images: 1,
  output_compression: 90
};

const output = await replicate.run("openai/gpt-image-1", { input });

// To access the file URL:
console.log(output[0].url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output[0]);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run openai/gpt-image-1 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "openai/gpt-image-1",
    input={
        "prompt": "Add the floral pattern to the vase",
        "quality": "auto",
        "background": "auto",
        "moderation": "auto",
        "aspect_ratio": "1:1",
        "input_images": ["https://replicate.delivery/pbxt/MusWuQJm1RJPu1Cj0ajRmoMnHyYNPk6ljT1QCU4DbHMsqDTF/53541851-62f3-44a7-b075-ef053ae2f324.jpg","https://replicate.delivery/pbxt/MusWuPkfcvyZQuuXeMIbQXEMe9K2G8rDCNraQffAt0OzMRaT/colored-flower-pattern-free-vector.jpg"],
        "output_format": "webp",
        "input_fidelity": "low",
        "openai_api_key": "",
        "number_of_images": 1,
        "output_compression": 90
    }
)

# To access the file URL:
print(output[0].url())
#=> "http://example.com"

# To write the file to disk:
with open("my-image.png", "wb") as file:
    file.write(output[0].read())

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run openai/gpt-image-1 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "input": {
      "prompt": "Add the floral pattern to the vase",
      "quality": "auto",
      "background": "auto",
      "moderation": "auto",
      "aspect_ratio": "1:1",
      "input_images": [{"value":"https://replicate.delivery/pbxt/MusWuQJm1RJPu1Cj0ajRmoMnHyYNPk6ljT1QCU4DbHMsqDTF/53541851-62f3-44a7-b075-ef053ae2f324.jpg"},{"value":"https://replicate.delivery/pbxt/MusWuPkfcvyZQuuXeMIbQXEMe9K2G8rDCNraQffAt0OzMRaT/colored-flower-pattern-free-vector.jpg"}],
      "output_format": "webp",
      "input_fidelity": "low",
      "openai_api_key": "",
      "number_of_images": 1,
      "output_compression": 90
    }
  }' \
  https://api.replicate.com/v1/models/openai/gpt-image-1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

Generated in

45.9 seconds

Tweak itReport View full prediction

Examples

View more examples

Pricing

Model pricing for openai/gpt-image-1. Looking for volume pricing? Get in touch.

per thousand output images

or 1,000 images for $1

Official models are always on, maintained, and have predictable pricing. Learn more.

Check out our docs for more information about how pricing works on Replicate.

Readme

GPT Image 1 is a new state-of-the-art image generation model. It is a natively multimodal language model that accepts both text and image inputs, and produces image outputs.

Capabilities

Creates images across diverse styles
Follows custom guidelines
Leverages world knowledge
Renders text accurately

Pricing

This is a bring-your-own-token model. You need to bring your own verified OpenAI key to use this model. Your OpenAI account will be charged for usage based on the following pricing.

See OpenAI’s pricing for details.