curl -X POST "https://t.ato2.nodesms.com/v1/images/edits/" \
-H "Authorization: Bearer $API_KEY" \
-F image="@otter.png" \
-F mask="@mask.png" \
-F prompt="A cute baby sea otter wearing a beret"
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxx",
base_url="https://t.ato2.nodesms.com/v1"
)
response = client.images.edit(
model="dall-e-2",
image=open("otter.png", "rb"),
mask=open("mask.png", "rb"),
prompt="A cute baby sea otter wearing a beret",
n=1,
size="1024x1024"
)
print(response.data[0].url)
{
"created": 1719123456,
"data": [
{
"url": "https://example.com/edited_image.png"
}
]
}
图像编辑
在给定原始图像和提示的情况下创建编辑或扩展图像。原生 OpenAI 格式。
POST
/
v1
/
images
/
edits
/
curl -X POST "https://t.ato2.nodesms.com/v1/images/edits/" \
-H "Authorization: Bearer $API_KEY" \
-F image="@otter.png" \
-F mask="@mask.png" \
-F prompt="A cute baby sea otter wearing a beret"
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxx",
base_url="https://t.ato2.nodesms.com/v1"
)
response = client.images.edit(
model="dall-e-2",
image=open("otter.png", "rb"),
mask=open("mask.png", "rb"),
prompt="A cute baby sea otter wearing a beret",
n=1,
size="1024x1024"
)
print(response.data[0].url)
{
"created": 1719123456,
"data": [
{
"url": "https://example.com/edited_image.png"
}
]
}
请求头
string
必填
Bearer Token 认证，格式：
Bearer <token>请求体
格式：multipart/form-data
file
必填
要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。格式：
binaryfile
附加图像，其完全透明区域（例如，alpha 为零的区域）指示
image 应编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与原始 image 相同。格式：binarystring
必填
所需图像的文本描述。最大长度为 1000 个字符。
string
要生成的图像数。必须介于 1 和 10 之间。
string
生成图像的大小。必须是
256x256、512x512 或 1024x1024 之一。string
生成的图像返回的格式。必须是
url 或 b64_json。string
模型 ID
响应
200
格式：application/json
integer
创建时间戳（Unix 时间）。
curl -X POST "https://t.ato2.nodesms.com/v1/images/edits/" \
-H "Authorization: Bearer $API_KEY" \
-F image="@otter.png" \
-F mask="@mask.png" \
-F prompt="A cute baby sea otter wearing a beret"
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxx",
base_url="https://t.ato2.nodesms.com/v1"
)
response = client.images.edit(
model="dall-e-2",
image=open("otter.png", "rb"),
mask=open("mask.png", "rb"),
prompt="A cute baby sea otter wearing a beret",
n=1,
size="1024x1024"
)
print(response.data[0].url)
{
"created": 1719123456,
"data": [
{
"url": "https://example.com/edited_image.png"
}
]
}
最后修改于 2026年10月28日
此页面对您有帮助吗？