AI 模型接口图像OpenAI Images 接口图像编辑
编辑图片
状态：已发布
状态依据：需要已启用的图像编辑/生成模型
图片编辑接口。请求体需使用 multipart/form-data 提交，image 必须上传原图文件，不支持通过 JSON 直接传图片 URL；可选参数包括 mask、n、size、quality、response_format、background、output_format、output_compression、moderation、watermark、user。
Authorization
BearerAuth
AuthorizationBearer <token>
模型 relay 接口鉴权。请求头：Authorization: Bearer 。
In: header
Request Body
multipart/form-data
model*string
图像编辑模型名称。
Default
"gpt-image-2"prompt*string
编辑提示词。
image*file
必填。要编辑的原图文件。当前上游要求文件上传，不支持用 JSON 直接传图片 URL。
Format
binarymask?file
可选。遮罩图片文件，透明区域表示需要编辑的区域。
Format
binaryn?integer
生成图片数量。
Format
int32Range
1 <= valuesize?string
输出图片尺寸。请使用明确的 <宽>x<高>，例如 1920x1920；总像素不得小于 3686400，实际可用值取决于模型和上游通道。
Default
"1920x1920"quality?string
图片质量。实际可选值取决于模型和上游通道。
Default
"auto"Value in
"auto" | "standard" | "hd" | "low" | "medium" | "high"response_format?string
返回格式。支持 url 或 b64_json；默认无需传此字段，不同上游通道支持情况可能不同。
Value in
"url" | "b64_json"background?string
背景填充方式。支持情况取决于模型。
Default
"auto"Value in
"transparent" | "opaque" | "auto"output_format?string
输出图片格式。支持情况取决于模型。
Default
"png"Value in
"png" | "jpeg" | "webp"output_compression?integer
输出压缩级别，仅适用于 jpeg 和 webp。
Default
90Format
int32Range
0 <= value <= 100moderation?string
安全审核强度。支持情况取决于模型。
Default
"auto"Value in
"auto" | "low"watermark?boolean
是否添加水印。支持情况取决于上游通道。
Default
falseuser?string
终端用户标识，可用于滥用监控。
Response Body
application/json
curl -X POST "https://api.tokaify.com/v1/images/edits" \ -F model="gpt-image-2" \ -F prompt="把图片改成水彩插画风格，保留主体构图。" \ -F image="@/path/to/image.jpg" \ -F n="1" \ -F size="1920x1920" \ -F quality="auto" \ -F background="auto" \ -F output_format="png" \ -F output_compression="90" \ -F moderation="auto" \ -F watermark="false" \ -F user="user-123"{
"created": 1,
"data": {}
}这篇文档对您有帮助吗？
最后更新于