图片编辑

← 生图模型目录 · 接口与鉴权先按快速开始设置 NONELINEAR_API_KEY；Python 需安装 openai。每个代码块可独立使用，只发送一次生成请求。图片地址请替换为您自己的公网 HTTPS 图片链接。

Python SDK 的扩展参数放在 extra_body 中；cURL 把这些字段放在 JSON 顶层。示例中的模型 ID 和参数需成套使用，不要只替换模型而保留不适用的尺寸。

通过 image 传入一张参考图，再用 prompt 描述要修改的内容，可用于增删元素、替换背景、转换风格等。支持编辑的模型见模型参数中的“支持任务”列。 image 必须是公网可直接访问的 HTTPS 图片地址，本地图片请先参考本地图片怎么传。 以 gpt-image-2 为例

curl -sS --max-time 300 \
  https://api.nonelinear.com.cn/v1/images/generations \
  -H "Authorization: Bearer $NONELINEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "将图片背景替换为简洁的浅灰色摄影棚背景，保留主体不变",
    "response_format": "url",
    "size": "1024x1024",
    "n": 1,
    "image": [
      "https://imagen-nonelinear-2025.tos-cn-beijing.volces.com/others/gen-1780570031-PVCF2SwnzQCRFdkiSkON-0.png"
    ]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nonelinear.com.cn/v1",
    api_key=os.environ["NONELINEAR_API_KEY"],
    timeout=300,
    max_retries=0,
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="将图片背景替换为简洁的浅灰色摄影棚背景，保留主体不变",
    response_format="url",
    size="1024x1024",
    n=1,
    extra_body={
        "image": [
            "https://imagen-nonelinear-2025.tos-cn-beijing.volces.com/others/gen-1780570031-PVCF2SwnzQCRFdkiSkON-0.png"
        ]
    },
)
for image in response.data or []:
    print(image.url or image.b64_json)

以 doubao-seedream-5-0-pro-260628 为例

curl -sS --max-time 600 \
  https://api.nonelinear.com.cn/v1/images/generations \
  -H "Authorization: Bearer $NONELINEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "保持柯基犬、草地、树林背景和原始构图不变，只给柯基犬脖子上增加一条清晰可见的红色格纹围巾，写实摄影风格",
    "response_format": "url",
    "size": "2K",
    "output_format": "png",
    "watermark": false,
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png"
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nonelinear.com.cn/v1",
    api_key=os.environ["NONELINEAR_API_KEY"],
    timeout=300,
    max_retries=0,
)

response = client.with_options(timeout=600).images.generate(
    model="doubao-seedream-5-0-pro-260628",
    prompt="保持柯基犬、草地、树林背景和原始构图不变，只给柯基犬脖子上增加一条清晰可见的红色格纹围巾，写实摄影风格",
    response_format="url",
    size="2K",
    extra_body={
        "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png",
        "output_format": "png",
        "watermark": False,
    },
)
for image in response.data or []:
    print(image.url or image.b64_json)

Seedream 5.0 Pro 还可以在 prompt 中用 <point>x y</point> 指定编辑位置，例如：

保持图1的树林、草地、光照和柯基犬不变，只在图1 <point>710 820</point> 所指的柯基犬头顶增加一顶小巧的金色皇冠，皇冠自然贴合头部，写实摄影风格

以 Qwen-Image-Edit 为例：该模型不需要传尺寸参数。

curl -sS --max-time 300 \
  https://api.nonelinear.com.cn/v1/images/generations \
  -H "Authorization: Bearer $NONELINEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen-Image-Edit",
    "prompt": "生成狗狗趴在草地上的近景画面",
    "response_format": "url",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png"
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nonelinear.com.cn/v1",
    api_key=os.environ["NONELINEAR_API_KEY"],
    timeout=300,
    max_retries=0,
)

response = client.images.generate(
    model="Qwen-Image-Edit",
    prompt="生成狗狗趴在草地上的近景画面",
    response_format="url",
    extra_body={
        "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png"
    },
)
for image in response.data or []:
    print(image.url or image.b64_json)

检查结果

以 data 中存在 url 或 b64_json 判断出图，并及时保存。未出图、参考图不可访问或超时，见生图排障。

开发基础

生图任务

框架集成

检查结果

​检查结果

检查结果