cURL
curl --request POST \
--url https://api.ttapi.io/v1/images/edits \
--header 'Content-Type: application/json' \
--header 'TT-API-KEY: <api-key>' \
--data '
{
"images": [
{
"file_id": "<string>",
"image_url": "<string>"
}
],
"prompt": "<string>",
"mask": {
"file_id": "<string>",
"image_url": "<string>"
},
"background": "auto",
"input_fidelity": "low",
"moderation": "auto",
"n": 123,
"output_compression": 100,
"output_format": "png",
"partial_images": 0,
"quality": "auto",
"size": "auto",
"stream": false,
"user": "<string>"
}
'import requests
url = "https://api.ttapi.io/v1/images/edits"
payload = {
"images": [
{
"file_id": "<string>",
"image_url": "<string>"
}
],
"prompt": "<string>",
"mask": {
"file_id": "<string>",
"image_url": "<string>"
},
"background": "auto",
"input_fidelity": "low",
"moderation": "auto",
"n": 123,
"output_compression": 100,
"output_format": "png",
"partial_images": 0,
"quality": "auto",
"size": "auto",
"stream": False,
"user": "<string>"
}
headers = {
"TT-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'TT-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
images: [{file_id: '<string>', image_url: '<string>'}],
prompt: '<string>',
mask: {file_id: '<string>', image_url: '<string>'},
background: 'auto',
input_fidelity: 'low',
moderation: 'auto',
n: 123,
output_compression: 100,
output_format: 'png',
partial_images: 0,
quality: 'auto',
size: 'auto',
stream: false,
user: '<string>'
})
};
fetch('https://api.ttapi.io/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://api.ttapi.io/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 => json_encode([
'images' => [
[
'file_id' => '<string>',
'image_url' => '<string>'
]
],
'prompt' => '<string>',
'mask' => [
'file_id' => '<string>',
'image_url' => '<string>'
],
'background' => 'auto',
'input_fidelity' => 'low',
'moderation' => 'auto',
'n' => 123,
'output_compression' => 100,
'output_format' => 'png',
'partial_images' => 0,
'quality' => 'auto',
'size' => 'auto',
'stream' => false,
'user' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"TT-API-KEY: <api-key>"
],
]);
$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://api.ttapi.io/v1/images/edits"
payload := strings.NewReader("{\n \"images\": [\n {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n }\n ],\n \"prompt\": \"<string>\",\n \"mask\": {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n },\n \"background\": \"auto\",\n \"input_fidelity\": \"low\",\n \"moderation\": \"auto\",\n \"n\": 123,\n \"output_compression\": 100,\n \"output_format\": \"png\",\n \"partial_images\": 0,\n \"quality\": \"auto\",\n \"size\": \"auto\",\n \"stream\": false,\n \"user\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("TT-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.ttapi.io/v1/images/edits")
.header("TT-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"images\": [\n {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n }\n ],\n \"prompt\": \"<string>\",\n \"mask\": {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n },\n \"background\": \"auto\",\n \"input_fidelity\": \"low\",\n \"moderation\": \"auto\",\n \"n\": 123,\n \"output_compression\": 100,\n \"output_format\": \"png\",\n \"partial_images\": 0,\n \"quality\": \"auto\",\n \"size\": \"auto\",\n \"stream\": false,\n \"user\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ttapi.io/v1/images/edits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["TT-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"images\": [\n {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n }\n ],\n \"prompt\": \"<string>\",\n \"mask\": {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n },\n \"background\": \"auto\",\n \"input_fidelity\": \"low\",\n \"moderation\": \"auto\",\n \"n\": 123,\n \"output_compression\": 100,\n \"output_format\": \"png\",\n \"partial_images\": 0,\n \"quality\": \"auto\",\n \"size\": \"auto\",\n \"stream\": false,\n \"user\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"created": 1713833628,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABhWlDQ1BJQ0MgcHJvZmlsZQAAKJF9kT1Iw0AcxV9TpSItDnaQIpKhOlkQVFIwU8CR1NZBLi4iFg8B4R33PTK77Z22p22e+628923923f/jH53eV73923/..."
}
],
"usage": {
"total_tokens": 100,
"input_tokens": 50,
"output_tokens": 50,
"input_tokens_details": {
"text_tokens": 10,
"image_tokens": 40
}
}
}{
"status": "FAILED",
"message": "\"prompt\" cannot be empty.",
"data": {}
}{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}OpenAI Image
OpenAI Images Edits
POST
/
v1
/
images
/
edits
cURL
curl --request POST \
--url https://api.ttapi.io/v1/images/edits \
--header 'Content-Type: application/json' \
--header 'TT-API-KEY: <api-key>' \
--data '
{
"images": [
{
"file_id": "<string>",
"image_url": "<string>"
}
],
"prompt": "<string>",
"mask": {
"file_id": "<string>",
"image_url": "<string>"
},
"background": "auto",
"input_fidelity": "low",
"moderation": "auto",
"n": 123,
"output_compression": 100,
"output_format": "png",
"partial_images": 0,
"quality": "auto",
"size": "auto",
"stream": false,
"user": "<string>"
}
'import requests
url = "https://api.ttapi.io/v1/images/edits"
payload = {
"images": [
{
"file_id": "<string>",
"image_url": "<string>"
}
],
"prompt": "<string>",
"mask": {
"file_id": "<string>",
"image_url": "<string>"
},
"background": "auto",
"input_fidelity": "low",
"moderation": "auto",
"n": 123,
"output_compression": 100,
"output_format": "png",
"partial_images": 0,
"quality": "auto",
"size": "auto",
"stream": False,
"user": "<string>"
}
headers = {
"TT-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'TT-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
images: [{file_id: '<string>', image_url: '<string>'}],
prompt: '<string>',
mask: {file_id: '<string>', image_url: '<string>'},
background: 'auto',
input_fidelity: 'low',
moderation: 'auto',
n: 123,
output_compression: 100,
output_format: 'png',
partial_images: 0,
quality: 'auto',
size: 'auto',
stream: false,
user: '<string>'
})
};
fetch('https://api.ttapi.io/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://api.ttapi.io/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 => json_encode([
'images' => [
[
'file_id' => '<string>',
'image_url' => '<string>'
]
],
'prompt' => '<string>',
'mask' => [
'file_id' => '<string>',
'image_url' => '<string>'
],
'background' => 'auto',
'input_fidelity' => 'low',
'moderation' => 'auto',
'n' => 123,
'output_compression' => 100,
'output_format' => 'png',
'partial_images' => 0,
'quality' => 'auto',
'size' => 'auto',
'stream' => false,
'user' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"TT-API-KEY: <api-key>"
],
]);
$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://api.ttapi.io/v1/images/edits"
payload := strings.NewReader("{\n \"images\": [\n {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n }\n ],\n \"prompt\": \"<string>\",\n \"mask\": {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n },\n \"background\": \"auto\",\n \"input_fidelity\": \"low\",\n \"moderation\": \"auto\",\n \"n\": 123,\n \"output_compression\": 100,\n \"output_format\": \"png\",\n \"partial_images\": 0,\n \"quality\": \"auto\",\n \"size\": \"auto\",\n \"stream\": false,\n \"user\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("TT-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.ttapi.io/v1/images/edits")
.header("TT-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"images\": [\n {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n }\n ],\n \"prompt\": \"<string>\",\n \"mask\": {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n },\n \"background\": \"auto\",\n \"input_fidelity\": \"low\",\n \"moderation\": \"auto\",\n \"n\": 123,\n \"output_compression\": 100,\n \"output_format\": \"png\",\n \"partial_images\": 0,\n \"quality\": \"auto\",\n \"size\": \"auto\",\n \"stream\": false,\n \"user\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ttapi.io/v1/images/edits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["TT-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"images\": [\n {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n }\n ],\n \"prompt\": \"<string>\",\n \"mask\": {\n \"file_id\": \"<string>\",\n \"image_url\": \"<string>\"\n },\n \"background\": \"auto\",\n \"input_fidelity\": \"low\",\n \"moderation\": \"auto\",\n \"n\": 123,\n \"output_compression\": 100,\n \"output_format\": \"png\",\n \"partial_images\": 0,\n \"quality\": \"auto\",\n \"size\": \"auto\",\n \"stream\": false,\n \"user\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"created": 1713833628,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABhWlDQ1BJQ0MgcHJvZmlsZQAAKJF9kT1Iw0AcxV9TpSItDnaQIpKhOlkQVFIwU8CR1NZBLi4iFg8B4R33PTK77Z22p22e+628923923f/jH53eV73923/..."
}
],
"usage": {
"total_tokens": 100,
"input_tokens": 50,
"output_tokens": 50,
"input_tokens_details": {
"text_tokens": 10,
"image_tokens": 40
}
}
}{
"status": "FAILED",
"message": "\"prompt\" cannot be empty.",
"data": {}
}{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}Create an edited or extended image from one or more source images and a prompt. The endpoint follows the official OpenAI Images API request and response shape for
POST /v1/images/edits.
Documentation translated from the official documentation.
Supported models include gpt-image-2, gpt-image-1.5, gpt-image-1, and dall-e-2.
Since OpenAI image editing is a synchronous response and takes a relatively long time, it is recommended to use the https://api.ttapi.org gateway.
Authorizations
You can obtain your API key from the TTAPI Dashboard.
Body
application/json
Input image references to edit. For GPT Image models, you can provide up to 16 images. Each object should provide either file_id or image_url.
Show child attributes
Show child attributes
Text prompt describing the desired edit. GPT Image models support up to 32,000 characters; dall-e-2 supports up to 1,000 characters.
The model to use for image editing.
Available options:
gpt-image-1.5, gpt-image-1, gpt-image-2 Optional mask image reference. Provide exactly one of file_id or image_url.
Show child attributes
Show child attributes
Sets the transparency of the output image background. Applies only to GPT Image models. Choose transparent, opaque, or auto (default). Transparent backgrounds require png or webp output format.
Available options:
transparent, opaque, auto Controls how closely the output preserves details from the input image. Choose high or low; defaults to low. Applies only to GPT Image models.
Available options:
high, low Moderation level for GPT Image models. Choose low or auto.
Available options:
low, auto Number of images to generate, default 1. Available range 1-10.
Compression level for generated images (0-100). Applies only to GPT Image models with output_format set to webp or jpeg; defaults to 100.
Return format for generated images. Applies only to GPT Image models. Choose png (default), jpeg, or webp.
Available options:
png, jpeg, webp Number of partial images to return in the streaming response, from 0 to 3; defaults to 0. Available only when stream is true.
Image quality. auto (default) automatically selects the best quality for the model.
GPT Image models support high, medium, and low;
dall-e-2 only supports standard.
Return data format. Only dall-e-2 supports url or b64_json; URLs are valid for 60 minutes. GPT Image models always return b64_json.
Available options:
url, b64_json Image size.
GPT Image models support 1024x1024, 1536x1024, 1024x1536, and auto (default);
dall-e-2 supports 256x256, 512x512, 1024x1024.
Whether to stream edit progress. When enabled, use partial_images to receive partial image events.
A unique identifier representing your end-user, which can help OpenAI monitor and detect abuse.
Response
Request successful, returns Base64 format image generation results
Generation timestamp (seconds)
Example:
1713833628
Image generation result list
Show child attributes
Show child attributes
Token usage (must return for Base64 format)
Show child attributes
Show child attributes
Example:
{
"input_tokens": 50,
"input_tokens_details": { "image_tokens": 40, "text_tokens": 10 },
"output_tokens": 50,
"total_tokens": 100
}
Last modified on June 16, 2026