GPT-Image-2 · 图生图
curl --request POST \
--url https://api.gravitex.ai/v1/images/edits \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>'import requests
url = "https://api.gravitex.ai/v1/images/edits"
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'}
};
fetch('https://api.gravitex.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://api.gravitex.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_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gravitex.ai/v1/images/edits"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
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.gravitex.ai/v1/images/edits")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gravitex.ai/v1/images/edits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
response = http.request(request)
puts response.read_bodyimage-2
GPT-Image-2 · 图生图
GPT-Image-2 Flare / Sunburst · POST /v1/images/edits
POST
/
v1
/
images
/
edits
GPT-Image-2 · 图生图
curl --request POST \
--url https://api.gravitex.ai/v1/images/edits \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>'import requests
url = "https://api.gravitex.ai/v1/images/edits"
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'}
};
fetch('https://api.gravitex.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://api.gravitex.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_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gravitex.ai/v1/images/edits"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
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.gravitex.ai/v1/images/edits")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gravitex.ai/v1/images/edits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
response = http.request(request)
puts response.read_body简介
GPT-Image-2 可通过POST /v1/images/edits 基于参考图片和文本指令完成重绘、风格迁移及多图参考。请明确描述修改内容和需要保留的细节。该模型始终以高保真处理输入图片,应省略 input_fidelity;局部区域编辑使用 mask。
认证
string
必填
Bearer $GRAVITEX_API_KEY
string
必填
application/json / multipart/form-data
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填,gpt-image-2 |
prompt | string | 必填,描述图片修改要求,最长 32,000 字符 |
quality | string | auto / low / medium / high;默认 auto |
size | string | auto 或 WxH,宽高为 16 的倍数;受模型尺寸和总像素预算约束 |
n | integer | 1–10;默认 1 |
background | string | auto / opaque / transparent;透明栅格输出使用 png 或 webp |
output_format | string | png / jpeg / webp;默认 png |
output_compression | integer | 0–100,默认 100,仅用于 JPEG / WebP |
moderation | string | auto / low;默认 auto |
safety_identifier | string | 稳定的终端用户标识,建议哈希化,最长 128 字符;替代 user |
stream | boolean | 默认 false;开启后返回 SSE 事件,不能按普通 JSON 响应解析 |
partial_images | integer | 仅栅格流式输出,0–3,默认 0;表示期望的中间预览数,实际可能更少 |
images / image[] | array / file | JSON 必填,至少一张参考图;使用 images: [{"image_url": "HTTPS URL 或 base64 data URI"}]。multipart 改用 image[] 文件字段 |
mask | object / file | 可选 PNG 蒙版,尺寸须与第一张参考图一致并包含 alpha 通道;完全透明区域表示需要编辑的位置。多图输入仅作用于第一张图 |
images / mask
JSON 使用images: [{"image_url": "https://..."}];也可传 base64 data URI。multipart 使用 image[] 上传文件。平台会将 JSON 编辑转为 multipart;不支持 OpenAI file_id 引用。此转换行为来自平台接入说明。
mask 可用于标识编辑区域,JSON 使用 image_url,multipart 上传文件。
请求示例
示例从环境变量GRAVITEX_API_KEY 读取平台令牌,请先在当前终端设置该变量。文件上传使用 curl 的 -F 自动生成 Content-Type 和 boundary,不要手动把 Content-Type 固定成 multipart/form-data。
图片引用请使用可访问的 HTTPS URL 或 base64 data URI。multipart 示例先下载官方图片再上传。平台接入说明不支持 OpenAI file_id 引用。
JSON
curl https://api.gravitex.ai/v1/images/edits \
-H "Authorization: Bearer $GRAVITEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Change the vase to blue. Keep everything else unchanged.",
"quality": "medium",
"size": "1024x1024",
"images": [
{
"image_url": "https://developers.openai.com/images/platform/guides/image-prompting/kitchen.webp"
}
]
}'
multipart/form-data
curl --fail --location "https://developers.openai.com/images/platform/guides/image-prompting/kitchen.webp" -o kitchen.webp
curl https://api.gravitex.ai/v1/images/edits \
-H "Authorization: Bearer $GRAVITEX_API_KEY" \
-F "model=gpt-image-2" \
-F "prompt=Change the vase to blue. Keep everything else unchanged." \
-F "image[]=@kitchen.webp"
user 为兼容旧请求保留,已废弃;新请求使用 safety_identifier。非空 safety_identifier 优先,未提供、null 或空字符串时才回退 user。
蒙版局部重绘
curl https://api.gravitex.ai/v1/images/edits \
-H "Authorization: Bearer $GRAVITEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Add a pink flamingo float in the masked pool area. Keep the rest of the room unchanged.",
"images": [
{
"image_url": "https://cdn.openai.com/API/docs/images/sunlit_lounge.png"
}
],
"mask": {
"image_url": "https://cdn.openai.com/API/docs/images/mask.png"
},
"quality": "medium"
}'
流式输出
curl --no-buffer https://api.gravitex.ai/v1/images/edits \
-H "Authorization: Bearer $GRAVITEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Change the vase to blue. Keep everything else unchanged.",
"quality": "medium",
"size": "1024x1024",
"stream": true,
"partial_images": 1,
"images": [
{
"image_url": "https://developers.openai.com/images/platform/guides/image-prompting/kitchen.webp"
}
]
}'
限制与注意事项
auto 为默认值。显式尺寸使用 WxH,宽高均为 16 的倍数,宽高比在 1:3–3:1 之间。image-2 官方指南规定最长边不超过 3840px、总像素为 655,360–8,294,400。 官方 Images API 的 JSON 编辑支持 1–16 张输入图片,PNG / JPEG / WebP,每张小于 50MB。mask 为带 alpha 通道的 PNG,须与第一张参考图尺寸一致;透明区域指定编辑位置,蒙版用于引导生成,不保证像素级硬裁剪。请勿把平台未主动校验理解为上游无限制。 quality 使用 auto / low / medium / high,默认 auto。透明背景是 image-2 的预览能力;可用时使用 background=transparent,且输出格式选 PNG 或 WebP。仅介绍栅格生成与编辑,不将 2.6 的 complexity、GIF、SVG 或 2.5 的 markup 能力直接套用。响应示例
下面是非流式响应的结构示意,图片数据和 token 数仅为示例,并非实际生成结果。将 b64_json 解码为对应格式的文件;不要将 Base64 字符串直接保存为图片。{
"created": 1794268800,
"data": [
{
"b64_json": "<BASE64_IMAGE_DATA>"
}
],
"usage": {
"input_tokens": 100,
"output_tokens": 824,
"total_tokens": 924
}
}
stream: true,响应为 SSE 事件流;按事件读取中间预览和最终图片,不能对整个响应直接调用 JSON 解析。
响应与计费
本页示例为非流式调用时,图片通过 b64_json 返回;不要传 response_format=url 期待图片链接。输入图片和输出图片均有 token 用量;相同 token 单价不代表相同单张费用,需结合实际 usage。 返回data[].b64_json 和 usage。图片数据须先 Base64 解码再保存。以下为 OpenAI 官方标准价,不是 GravitexAI 报价。
缓存价格是官方参考费率。官方指南说明,GPT Image 2 / 2.5 的缓存输入优惠仅适用于 Responses API 图像工具,不适用于直接调用本页 Images API(含 edits);平台实际结算以控制台为准。
| 类型 | 美元 / 1M tokens |
|---|---|
| 文本输入 | $5.00 |
| 缓存文本输入 | $1.25 |
| 图片输入 | $8.00 |
| 缓存图片输入 | $2.00 |
| 图片输出 | $30.00 |
