编辑图片
curl --request POST \
--url https://api.upmore.net/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2.5-flare",
"prompt": "把狐狸的毛变成亮蓝色,并加上飘落的雪花",
"images": [
{
"image_url": "https://your-bucket.tos-cn-beijing.volces.com/fox.png",
"file_id": "<string>"
}
],
"mask": {
"image_url": "<string>"
},
"n": 1,
"size": "1024x1024",
"quality": "low",
"background": "opaque",
"output_format": "png",
"output_compression": 50,
"moderation": "auto",
"stream": false,
"partial_images": 123
}
'import requests
url = "https://api.upmore.net/v1/images/edits"
payload = {
"model": "gpt-image-2.5-flare",
"prompt": "把狐狸的毛变成亮蓝色,并加上飘落的雪花",
"images": [
{
"image_url": "https://your-bucket.tos-cn-beijing.volces.com/fox.png",
"file_id": "<string>"
}
],
"mask": { "image_url": "<string>" },
"n": 1,
"size": "1024x1024",
"quality": "low",
"background": "opaque",
"output_format": "png",
"output_compression": 50,
"moderation": "auto",
"stream": False,
"partial_images": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'gpt-image-2.5-flare',
prompt: '把狐狸的毛变成亮蓝色,并加上飘落的雪花',
images: [
{
image_url: 'https://your-bucket.tos-cn-beijing.volces.com/fox.png',
file_id: '<string>'
}
],
mask: {image_url: '<string>'},
n: 1,
size: '1024x1024',
quality: 'low',
background: 'opaque',
output_format: 'png',
output_compression: 50,
moderation: 'auto',
stream: false,
partial_images: 123
})
};
fetch('https://api.upmore.net/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.upmore.net/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([
'model' => 'gpt-image-2.5-flare',
'prompt' => '把狐狸的毛变成亮蓝色,并加上飘落的雪花',
'images' => [
[
'image_url' => 'https://your-bucket.tos-cn-beijing.volces.com/fox.png',
'file_id' => '<string>'
]
],
'mask' => [
'image_url' => '<string>'
],
'n' => 1,
'size' => '1024x1024',
'quality' => 'low',
'background' => 'opaque',
'output_format' => 'png',
'output_compression' => 50,
'moderation' => 'auto',
'stream' => false,
'partial_images' => 123
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.upmore.net/v1/images/edits"
payload := strings.NewReader("{\n \"model\": \"gpt-image-2.5-flare\",\n \"prompt\": \"把狐狸的毛变成亮蓝色,并加上飘落的雪花\",\n \"images\": [\n {\n \"image_url\": \"https://your-bucket.tos-cn-beijing.volces.com/fox.png\",\n \"file_id\": \"<string>\"\n }\n ],\n \"mask\": {\n \"image_url\": \"<string>\"\n },\n \"n\": 1,\n \"size\": \"1024x1024\",\n \"quality\": \"low\",\n \"background\": \"opaque\",\n \"output_format\": \"png\",\n \"output_compression\": 50,\n \"moderation\": \"auto\",\n \"stream\": false,\n \"partial_images\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.upmore.net/v1/images/edits")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"gpt-image-2.5-flare\",\n \"prompt\": \"把狐狸的毛变成亮蓝色,并加上飘落的雪花\",\n \"images\": [\n {\n \"image_url\": \"https://your-bucket.tos-cn-beijing.volces.com/fox.png\",\n \"file_id\": \"<string>\"\n }\n ],\n \"mask\": {\n \"image_url\": \"<string>\"\n },\n \"n\": 1,\n \"size\": \"1024x1024\",\n \"quality\": \"low\",\n \"background\": \"opaque\",\n \"output_format\": \"png\",\n \"output_compression\": 50,\n \"moderation\": \"auto\",\n \"stream\": false,\n \"partial_images\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.upmore.net/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["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"gpt-image-2.5-flare\",\n \"prompt\": \"把狐狸的毛变成亮蓝色,并加上飘落的雪花\",\n \"images\": [\n {\n \"image_url\": \"https://your-bucket.tos-cn-beijing.volces.com/fox.png\",\n \"file_id\": \"<string>\"\n }\n ],\n \"mask\": {\n \"image_url\": \"<string>\"\n },\n \"n\": 1,\n \"size\": \"1024x1024\",\n \"quality\": \"low\",\n \"background\": \"opaque\",\n \"output_format\": \"png\",\n \"output_compression\": 50,\n \"moderation\": \"auto\",\n \"stream\": false,\n \"partial_images\": 123\n}"
response = http.request(request)
puts response.read_body{
"created": 123,
"background": "<string>",
"output_format": "<string>",
"quality": "<string>",
"size": "<string>",
"data": [
{
"b64_json": "<string>"
}
],
"usage": {
"input_tokens": 123,
"input_tokens_details": {
"image_tokens": 123,
"text_tokens": 123
},
"output_tokens": 123,
"total_tokens": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}OpenAI
gpt-image-2.5 · 图生图
用文本提示词编辑已有图片,可选传入额外参考图与蒙版。请求体为 multipart/form-data。
POST
/
v1
/
images
/
edits
编辑图片
curl --request POST \
--url https://api.upmore.net/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2.5-flare",
"prompt": "把狐狸的毛变成亮蓝色,并加上飘落的雪花",
"images": [
{
"image_url": "https://your-bucket.tos-cn-beijing.volces.com/fox.png",
"file_id": "<string>"
}
],
"mask": {
"image_url": "<string>"
},
"n": 1,
"size": "1024x1024",
"quality": "low",
"background": "opaque",
"output_format": "png",
"output_compression": 50,
"moderation": "auto",
"stream": false,
"partial_images": 123
}
'import requests
url = "https://api.upmore.net/v1/images/edits"
payload = {
"model": "gpt-image-2.5-flare",
"prompt": "把狐狸的毛变成亮蓝色,并加上飘落的雪花",
"images": [
{
"image_url": "https://your-bucket.tos-cn-beijing.volces.com/fox.png",
"file_id": "<string>"
}
],
"mask": { "image_url": "<string>" },
"n": 1,
"size": "1024x1024",
"quality": "low",
"background": "opaque",
"output_format": "png",
"output_compression": 50,
"moderation": "auto",
"stream": False,
"partial_images": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'gpt-image-2.5-flare',
prompt: '把狐狸的毛变成亮蓝色,并加上飘落的雪花',
images: [
{
image_url: 'https://your-bucket.tos-cn-beijing.volces.com/fox.png',
file_id: '<string>'
}
],
mask: {image_url: '<string>'},
n: 1,
size: '1024x1024',
quality: 'low',
background: 'opaque',
output_format: 'png',
output_compression: 50,
moderation: 'auto',
stream: false,
partial_images: 123
})
};
fetch('https://api.upmore.net/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.upmore.net/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([
'model' => 'gpt-image-2.5-flare',
'prompt' => '把狐狸的毛变成亮蓝色,并加上飘落的雪花',
'images' => [
[
'image_url' => 'https://your-bucket.tos-cn-beijing.volces.com/fox.png',
'file_id' => '<string>'
]
],
'mask' => [
'image_url' => '<string>'
],
'n' => 1,
'size' => '1024x1024',
'quality' => 'low',
'background' => 'opaque',
'output_format' => 'png',
'output_compression' => 50,
'moderation' => 'auto',
'stream' => false,
'partial_images' => 123
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.upmore.net/v1/images/edits"
payload := strings.NewReader("{\n \"model\": \"gpt-image-2.5-flare\",\n \"prompt\": \"把狐狸的毛变成亮蓝色,并加上飘落的雪花\",\n \"images\": [\n {\n \"image_url\": \"https://your-bucket.tos-cn-beijing.volces.com/fox.png\",\n \"file_id\": \"<string>\"\n }\n ],\n \"mask\": {\n \"image_url\": \"<string>\"\n },\n \"n\": 1,\n \"size\": \"1024x1024\",\n \"quality\": \"low\",\n \"background\": \"opaque\",\n \"output_format\": \"png\",\n \"output_compression\": 50,\n \"moderation\": \"auto\",\n \"stream\": false,\n \"partial_images\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.upmore.net/v1/images/edits")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"gpt-image-2.5-flare\",\n \"prompt\": \"把狐狸的毛变成亮蓝色,并加上飘落的雪花\",\n \"images\": [\n {\n \"image_url\": \"https://your-bucket.tos-cn-beijing.volces.com/fox.png\",\n \"file_id\": \"<string>\"\n }\n ],\n \"mask\": {\n \"image_url\": \"<string>\"\n },\n \"n\": 1,\n \"size\": \"1024x1024\",\n \"quality\": \"low\",\n \"background\": \"opaque\",\n \"output_format\": \"png\",\n \"output_compression\": 50,\n \"moderation\": \"auto\",\n \"stream\": false,\n \"partial_images\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.upmore.net/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["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"gpt-image-2.5-flare\",\n \"prompt\": \"把狐狸的毛变成亮蓝色,并加上飘落的雪花\",\n \"images\": [\n {\n \"image_url\": \"https://your-bucket.tos-cn-beijing.volces.com/fox.png\",\n \"file_id\": \"<string>\"\n }\n ],\n \"mask\": {\n \"image_url\": \"<string>\"\n },\n \"n\": 1,\n \"size\": \"1024x1024\",\n \"quality\": \"low\",\n \"background\": \"opaque\",\n \"output_format\": \"png\",\n \"output_compression\": 50,\n \"moderation\": \"auto\",\n \"stream\": false,\n \"partial_images\": 123\n}"
response = http.request(request)
puts response.read_body{
"created": 123,
"background": "<string>",
"output_format": "<string>",
"quality": "<string>",
"size": "<string>",
"data": [
{
"b64_json": "<string>"
}
],
"usage": {
"input_tokens": 123,
"input_tokens_details": {
"image_tokens": 123,
"text_tokens": 123
},
"output_tokens": 123,
"total_tokens": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/jsonmultipart/form-data
图像模型。两个模型名等价,任选其一。
可用选项:
gpt-image-2.5-flare, gpt-image-2.5-sunburst 示例:
"gpt-image-2.5-flare"
期望的修改描述。
示例:
"把狐狸的毛变成亮蓝色,并加上飘落的雪花"
要编辑的源图。用这个 JSON 形式可以传 URL,而不必上传文件。
Required array length:
1 - 16 elementsShow child attributes
Show child attributes
可编辑区域。须为带 alpha 通道、且与源图同尺寸的 PNG。
Show child attributes
Show child attributes
生成图片数量。
必填范围:
1 <= x <= 10{width}x{height} 格式。边长须为 16 的倍数,宽高比 ≤ 3:1,总像素 655,360–8,294,400,最长边 3,840px。不传则由模型自行选择(约 130 万像素)。
示例:
"1024x1024"
渲染质量。
可用选项:
low, medium, high, auto 背景处理方式。
可用选项:
opaque, transparent, auto 输出图片格式。
可用选项:
png, jpeg jpeg 输出的压缩级别。
必填范围:
0 <= x <= 100内容审核严格程度。
可用选项:
auto, low 是否以 SSE 推送中间帧。
stream 为 true 时请求的预览帧数量。