N·00API 生图

用 API 生成图片

生图有两种协议:Images API 直接按描述出图(/v1/images/generations)或在已有图片上修改(/v1/images/edits);Responses 接口让对话模型把出图当成工具调用,适合多轮修改。地址和文本调用一样是 https://api.xylemnode.com/v1,不必再单独接一套图像服务;直接调 Images API 时,Key 要选包含生图模型的分组。

Images API:生成与编辑

只想要图,直接调图像接口最省事:一次请求返回成品,不经过对话模型。生成用 JSON 请求体,改图用表单上传原图;两者都用 Bearer 鉴权,返回的 data 数组里每一项都是一张图的 Base64。

  1. 01

    按描述生成:/v1/images/generations

    model 填生图模型,prompt 写描述,size 和 quality 按需要填。GPT Image 系列只返回 b64_json(图片的 Base64),不给图片链接,解码成文件即可。下面的 curl 适用于 macOS / Linux,结尾用 jq 和 base64 把图片解出来存成文件;Windows 直接看后面的 Python 写法。

    terminal
    curl https://api.xylemnode.com/v1/images/generations \
      -H "Authorization: Bearer sk-你的密钥" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-image-2.5-flare",
        "prompt": "一只穿着宇航服的橘猫站在月球上,远处是蓝色地球,电影感光影,写实风格。",
        "size": "1024x1536",
        "quality": "high"
      }' | jq -r '.data[0].b64_json' | base64 --decode > moon-cat.png
  2. 02

    在已有图片上修改:/v1/images/edits

    改图用表单(multipart/form-data)上传:image[] 放原图,最多 16 张,png、webp 或 jpg 均可,单张小于 50MB,传多张时模型会把它们当参考合成一张;prompt 写怎么改。只想改局部,再传一张 mask:与原图同尺寸、小于 4MB、带透明通道的 PNG,完全透明的区域就是要重画的地方(模型把蒙版当参考,不保证严格按轮廓改),多张原图时只作用于第一张。文件名要带对扩展名(.png / .jpg / .webp),curl 会自己设好表单格式,不要手动加 Content-Type。

    terminal
    curl https://api.xylemnode.com/v1/images/edits \
      -H "Authorization: Bearer sk-你的密钥" \
      -F "model=gpt-image-2.5-sunburst" \
      -F "image[][email protected]" \
      -F "[email protected]" \
      -F "prompt=把沙发换成墨绿色丝绒沙发,其余保持不变" \
      | jq -r '.data[0].b64_json' | base64 --decode > living-room-edited.png
  3. 03

    Python 写法(Windows 也适用)

    同样两个接口的 Python 版本,只依赖 requests:生成发 JSON,改图用 files 上传文件,两者都从 data[0].b64_json 取图。

    python
    import base64
    import requests
    
    API = "https://api.xylemnode.com/v1"
    HEADERS = {"Authorization": "Bearer sk-你的密钥"}
    
    # 按描述生成
    result = requests.post(
        f"{API}/images/generations",
        headers=HEADERS,
        json={
            "model": "gpt-image-2.5-flare",
            "prompt": "一只穿着宇航服的橘猫站在月球上,远处是蓝色地球,电影感光影,写实风格。",
            "size": "1024x1536",
            "quality": "high",
        },
        timeout=600,
    )
    result.raise_for_status()
    with open("moon-cat.png", "wb") as file:
        file.write(base64.b64decode(result.json()["data"][0]["b64_json"]))
    
    # 在已有图片上修改(mask 可选)
    with open("living-room.png", "rb") as image, open("mask.png", "rb") as mask:
        result = requests.post(
            f"{API}/images/edits",
            headers=HEADERS,
            data={"model": "gpt-image-2.5-sunburst", "prompt": "把沙发换成墨绿色丝绒沙发,其余保持不变"},
            files=[
                ("image[]", ("living-room.png", image, "image/png")),
                ("mask", ("mask.png", mask, "image/png")),
            ],
            timeout=600,
        )
    result.raise_for_status()
    with open("living-room-edited.png", "wb") as file:
        file.write(base64.b64decode(result.json()["data"][0]["b64_json"]))
  4. 04

    常用参数

    两个接口通用。size 也接受自定义宽高:两边都是 16 的倍数,长宽比在 1:3 到 3:1 之间,单边不超过 3840,总像素在 655,360 到 8,294,400 之间(比如 1024x640 到 3840x2160);超过 2560x1440 的尺寸目前属实验性。生图模型按需要选:gpt-image-2.5-flare 快,适合日常出图;gpt-image-2.5-sunburst 更精细,适合改图,以后台可用列表为准。

    n
    一次出几张,1–10
    size
    1024x1024 · 1536x1024 · 1024x1536 · auto
    quality
    low · medium · high · auto(2.5 系列另有 xhigh · max)
    background
    auto · opaque · transparent(透明需配 png 或 webp)
    output_format
    png · jpeg · webp
    output_compression
    0–100,仅 jpeg / webp

接口一览

按描述生成
POST https://api.xylemnode.com/v1/images/generations(JSON)
改图 / 合成
POST https://api.xylemnode.com/v1/images/edits(multipart)
生图模型
gpt-image-2.5-flare · gpt-image-2.5-sunburst
取图字段
data[].b64_json(Base64)