Edit Image - Requesty Docs

Edit image

curl --request POST \
  --url https://router.requesty.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=azure/openai/gpt-image-1 \
  --form 'prompt=<string>' \
  --form 'image[]=@example-file' \
  --form mask=@example-file

import requests

url = "https://router.requesty.ai/v1/images/edits"

files = {
    "image[]": ("example-file", open("example-file", "rb")),
    "mask": ("example-file", open("example-file", "rb"))
}
payload = {
    "model": "azure/openai/gpt-image-1",
    "prompt": "<string>"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('model', 'azure/openai/gpt-image-1');
form.append('prompt', '<string>');
form.append('image[]', '<string>');
form.append('mask', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://router.requesty.ai/v1/images/edits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://router.requesty.ai/v1/images/edits",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://router.requesty.ai/v1/images/edits"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://router.requesty.ai/v1/images/edits")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://router.requesty.ai/v1/images/edits")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "created": 1719000000,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>"
    }
  ]
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

POST

images

edits

Edit image

curl --request POST \
  --url https://router.requesty.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=azure/openai/gpt-image-1 \
  --form 'prompt=<string>' \
  --form 'image[]=@example-file' \
  --form mask=@example-file

import requests

url = "https://router.requesty.ai/v1/images/edits"

files = {
    "image[]": ("example-file", open("example-file", "rb")),
    "mask": ("example-file", open("example-file", "rb"))
}
payload = {
    "model": "azure/openai/gpt-image-1",
    "prompt": "<string>"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('model', 'azure/openai/gpt-image-1');
form.append('prompt', '<string>');
form.append('image[]', '<string>');
form.append('mask', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://router.requesty.ai/v1/images/edits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://router.requesty.ai/v1/images/edits",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://router.requesty.ai/v1/images/edits"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://router.requesty.ai/v1/images/edits")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://router.requesty.ai/v1/images/edits")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nazure/openai/gpt-image-1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image[]\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "created": 1719000000,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>"
    }
  ]
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

Edit or extend an existing image from a text prompt using OpenAI compatible image editing models through Requesty’s routing.

Base URL

https://router.requesty.ai/v1/images/edits

Authentication

Include your Requesty API key in the request headers:

Authorization: Bearer YOUR_REQUESTY_API_KEY

Example Request

The endpoint accepts both multipart/form-data (the OpenAI SDK default for file uploads) and application/json. In JSON, each entry of image is an object whose image_url is a base64 data URL (data:image/png;base64,...).

multipart/form-data

curl https://router.requesty.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_REQUESTY_API_KEY" \
  -F "model=openai/gpt-image-2" \
  -F "prompt=Make the sky a dramatic sunset" \
  -F "image[]=@./photo.png" \
  -F "size=1024x1024" \
  -F "quality=auto"

For multiple input images, repeat the same form field once per file:

curl https://router.requesty.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_REQUESTY_API_KEY" \
  -F "model=openai/gpt-image-2" \
  -F "prompt=Combine these references into one image" \
  -F "image[]=@./photo-1.png" \
  -F "image[]=@./photo-2.png" \
  -F "image[]=@./photo-3.png" \
  -F "size=1024x1024" \
  -F "quality=auto"

application/json

curl https://router.requesty.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_REQUESTY_API_KEY" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "Make the sky a dramatic sunset",
    "image": [
      { "image_url": "data:image/png;base64,iVBORw0KGgo..." }
    ],
    "size": "1024x1024",
    "quality": "auto"
  }'

image_url must be a base64 data URL. The router does not download images from http:// or https:// URLs, so a remote URL fails with an error. Encode the file yourself (for example base64 -w0 photo.png) or send the file with the multipart form instead.

Supported Models

openai/gpt-image-2 OpenAI’s GPT Image 2 model
azure/openai/gpt-image-2 OpenAI’s GPT Image 2 model via Azure
azure/openai/gpt-image-1.5 OpenAI’s GPT Image 1.5 model via Azure
azure/openai/gpt-image-1 OpenAI’s GPT Image 1 model via Azure
vertex/google/gemini-3.1-flash-image Google’s Gemini 3.1 Flash Image model via Vertex AI
vertex/google/gemini-2.5-flash-image Google’s Gemini 2.5 Flash Image model via Vertex AI

Gemini image models use size for the output aspect ratio and ignore the GPT Image specific parameters such as quality, background and output_format. Browse the Model Library for the full list of image models.

Masked Edits

Provide a mask image to restrict edits to a specific region. Transparent pixels in the mask are the area that will be regenerated.

curl https://router.requesty.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_REQUESTY_API_KEY" \
  -F "model=openai/gpt-image-2" \
  -F "prompt=Replace the background with a forest" \
  -F "image[]=@./portrait.png" \
  -F "mask=@./mask.png" \
  -F "size=1024x1024"

Transparent Backgrounds

Use the background parameter together with output_format=png (or webp) to produce edits with transparent backgrounds:

curl https://router.requesty.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_REQUESTY_API_KEY" \
  -F "model=openai/gpt-image-2" \
  -F "prompt=Isolate the product on a transparent background" \
  -F "image[]=@./product.png" \
  -F "background=transparent" \
  -F "output_format=png"

Error Handling

The API returns standard HTTP status codes:

200 Success
400 Bad Request (invalid parameters)
401 Unauthorized (invalid API key)
413 Payload Too Large (uploaded images exceed the size limit)
429 Rate Limited
500 Internal Server Error

This endpoint is fully compatible with the OpenAI Images API. You can use the OpenAI SDK’s client.images.edit() method directly.

To generate a new image from scratch rather than edit an existing one, use the Create Image endpoint. See the Image Generation feature guide for a full comparison.

Authorizations

Authorization

string

header

required

API key for authentication

Body

model

string

required

The model to use for image editing

Example:

"azure/openai/gpt-image-1"

prompt

string

required

A text description of the desired edit

image[]

file[]

required

One or more image files to edit. Repeat the image[] field to upload multiple images (up to 16 for GPT image models).

size

enum<string>

Output size. Defaults to auto.

Available options:

auto,

1024x1024,

1536x1024,

1024x1536

quality

enum<string>

Image quality. Defaults to auto.

Available options:

auto,

high,

medium,

low

mask

file

Optional mask image file. Transparent pixels mark the area that will be regenerated.

Response

Image edit response

created

integer

required

The Unix timestamp of when the image was created

Example:

1719000000

data

object[]

required

The list of generated images

Show child attributes

Last modified on October 12, 2026

​Base URL

​Authentication

​Example Request

​multipart/form-data

​application/json

​Supported Models

​Masked Edits

​Transparent Backgrounds

​Error Handling

Authorizations

Body

Response

Base URL

Authentication

Example Request

multipart/form-data

application/json

Supported Models

Masked Edits

Transparent Backgrounds

Error Handling