图片编辑 / edits接口 - you-token文档

根据一个或多个原始图片和提示创建编辑或扩展的图片。此端点支持 dall-e-2 和 gpt-image-1 模型。
官方文档：https://platform.openai.com/docs/api-reference/images/createEdit
注意事项：
还在世的艺术家名称（如「宫崎骏」、「新海诚」等）会触发 moderation_blocked 报错，导致生成失败。你可以通过「吉卜力」、「明亮的现代日式动漫风格」等非敏感词来规避。衣着暴露或含有暗示的图片同理。
总的来说,「风格」比「艺术家」安全，像是「皮克斯」也是支持的。
更稳妥的做法是采用已故艺术家或对应的风格，如「梵高」、「蒙娜丽莎」等。
对于单次请求生成 2-10 张图片的情况，如果系统检测到请求涉嫌违反平台政策，该请求中的违规部分将不会被生成。这可能导致实际生成图片数量少于用户请求数量，然而多图的情况下，不会抛出 moderation_blocked。因此，请在创作中主动规避潜在的知识产权（IP）或版权问题，以减少生成被系统拦截的风险，确保创作顺利完成。
✍️ 关键提示：
避免直接使用已知的受版权保护角色、品牌标志、名人肖像等
可以采用「风格借鉴」「创意改编」「泛指描述」等方式表达
若需引用特定元素，请提前确认该元素是否处于公有领域
实用提示
支持任何语言，中文绘制也很稳定，但我们也不建议绘制大量的文本
size 参数不支持显示传入 size=“auto”，默认即 auto
画幅比例可以在 prompt 中指定，支持 2:3、3:2、1:1，也可以在 size 参数中设置。
支持控制敏感度的 moderation 参数，但这个参数设为 low 也可能被拒，比如说维纳斯过于暴露
edits 端口不支持 moderation 参数
文本描述和参考图搭配，融图效果更准确
上传的图片可以做压缩预处理，提升速度
支持透明背景，免抠图。——只需要在 Prompt 中补充要求

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "model": "dall-e-3",
    "quality": "hd",
    "prompt": "a white siamese cat",
    "n": 1,
    "size": "1024x1024"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "created": 1760483997,
    "data": [
        {
            "revised_prompt": "A white Siamese cat with sleek fur and bright blue eyes, sitting elegantly on a soft cushion by a sunny window. The sunlight is streaming through the window, creating a warm and cozy ambiance. The background features a blurred view of a garden outside the window, hinting at flowers and greenery, while the cat exudes an air of grace and poise.",
            "url": "https://dalleprodsec.blob.core.windows.net/private/images/971071d6-3b7f-4a71-ab81-a5799a148628/generated_00.png?se=2025-10-15T23%3A20%3A12Z&sig=ko7zSeMfSXPv2X5o0RJal5KbURn5qUUgCHtwMEmJHtk%3D&ske=2025-10-15T19%3A00%3A58Z&skoid=e52d5ed7-0657-4f62-bc12-7e5dbb260a96&sks=b&skt=2025-10-08T19%3A00%3A58Z&sktid=33e01921-4d64-4f8c-a055-5bdaffd5e33d&skv=2020-10-02&sp=r&spr=https&sr=b&sv=2020-10-02"
        }
    ]
}