图片生成

图片生成接口用于根据文本提示词生成图片。

需要避免长连接超时或希望后台处理时，请使用异步生图接口。异步模式仍提交到本页接口，只需增加 Prefer: respond-async 请求头。

请求地址

POST /v1/images/generations

curl 示例

curl https://code.ciyuanapi.xyz/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在窗边，柔和自然光，写实摄影风格",
    "size": "1024x1024",
    "quality": "standard",
    "n": 1
  }'

常用字段

字段	说明
model	图片模型名称
prompt	生图提示词
size	图片尺寸
quality	质量档位
n	生成数量

同步与异步

• 不带 Prefer: respond-async：等待生成完成后直接返回图片结果。
• 带 Prefer: respond-async：立即返回 HTTP 202 和任务 ID，随后轮询任务状态。

完整请求、查询和失败处理示例见异步生图。