图片生成

POST/v1/images/generations

生成图片时最常用的统一接口

统一图片生成接口,支持 prompt、n、size、quality、image_url 等字段。按张计费模型会根据最终返回张数结算。

如果你已经完成文本接口联调,下一步通常就可以开始测试图片生成。先从最简单的 prompt + n + size 组合开始最稳妥。

请求方法

POST /v1/images/generations

最常见用途

文生图、海报、插画、产品图、封面图生成

推荐首测方式

先生成 1 张图片,确认模型、权限和返回格式都正确

什么时候用这个接口

1
文生图时

当你希望模型根据一段文字直接生成图片时,通常先调用这个接口。

2
调风格和尺寸时

当你要测试不同 size、quality 或多张返回时,也是在这个接口上完成。

3
做首次图片联调时

建议先从最简单的参数开始,确认能生成结果后,再增加复杂参数或参考图输入。

CURL 示例

CURL
curl https://api.wei.run/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0",
    "prompt": "A clean editorial product poster",
    "n": 2,
    "size": "1024*1024"
  }'

使用时请注意

  • 先确认你填写的 model 是当前平台真实可用的图片模型 ID。
  • 第一次测试时建议把 n 设为 1,这样更容易确认返回结果和计费行为。
  • 如果返回了图片 URL、图片数据或平台定义的成功结果,说明图片接口已经接通。