图片生成 API · Weason 文档

程序化文字生图使用 POST https://weason.cn/v1/images/generations。以下说明针对支持 OpenAI 图片生成格式的模型与渠道。

先选择图片模型

公开目录中可以看到 gpt-image-2、gpt-image-2.5、gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 等图片模型。名称和可用分组可能调整，请查看模型目录和价格页。

这些名称是 Weason 平台暴露的模型 ID。并非所有图片模型都支持相同参数；Gemini 图片渠道的调用方式也可能不同。

最小请求示例

先设置 WEASON_API_KEY，并确保该 Key 可以调用 gpt-image-2.5。下面的请求会产生实际生图消耗。

bash

curl --fail-with-body --max-time 600 \
  https://weason.cn/v1/images/generations \
  -H "Authorization: Bearer $WEASON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "白色背景上的一盆小型绿植，柔和自然光，产品摄影，无文字",
    "n": 1,
    "size": "1024x1024"
  }' > image-response.json

首次使用先提交较小尺寸，确认可用后再提高分辨率。如果模型不接受 n 或 size，根据错误体和分组说明调整参数。

处理返回结果

返回内容通常位于 data 数组中。渠道可能返回 Base64 图片，也可能返回下载 URL。

python

import base64
import json
from pathlib import Path

payload = json.loads(Path("image-response.json").read_text())
item = payload["data"][0]
if item.get("b64_json"):
    Path("image.png").write_bytes(base64.b64decode(item["b64_json"]))
elif item.get("url"):
    print("请及时下载返回的图片地址：", item["url"])
else:
    raise RuntimeError("未返回图片，请检查完整响应")

输出格式取决于渠道。保存后检查文件能否打开，不要把 JSON 错误体改后缀当成图片。临时下载链接可能过期，结果应及时保存。

参数与重试

quality、输出格式、参考图、遮罩和透明背景的支持程度由模型与接口决定。文字生图示例不能直接用于图片编辑；编辑还需对应接口和渠道能力。

图片请求耗时较长。客户端超时不一定意味着上游没有完成。先查看调用记录，不要无限自动重试；需要批量时从低并发开始。