图片生成
XNova 支持 OpenAI 兼容的图片生成接口，可用于图片站、桌面客户端和自定义脚本。
端点
txt
POST https://api.xnova.online/v1/images/generations
POST https://api.xnova.online/v1/images/edits常用参数
| 参数 | 说明 |
|---|---|
model | 图片模型，例如 gpt-image-2 |
prompt | 图片提示词 |
size | 图片尺寸或档位 |
quality | auto、low、medium、high |
output_format | png、jpeg、webp |
output_compression | JPEG/WebP 压缩率，PNG 不发送 |
moderation | auto 或 low |
n | 生成数量，大于 1 时发送 |
文生图示例
bash
curl https://api.xnova.online/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一张干净的产品海报，白色背景，柔和光线",
"size": "2880x2880",
"quality": "auto",
"output_format": "png",
"moderation": "auto"
}'图像编辑
图像编辑使用 multipart 请求上传参考图，必要时上传遮罩。
bash
curl https://api.xnova.online/v1/images/edits \
-H "Authorization: Bearer sk-你的密钥" \
-F "model=gpt-image-2" \
-F "prompt=把背景改成极简工作室" \
-F "size=auto" \
-F "image[]=@input.png"常见错误
接口没有返回图片数据：上游没有返回可解析图片，建议查看原始响应。403：可能是上游账号、权限或内容策略问题。CORS：浏览器站点需要 API 服务放行对应域名。