图像生成

通过文本提示或参考图生成 AI 图像

图像生成 API 提供了同步和异步生成 AI 图像的能力。

接口路径

POST /api/ai/images/generations

请求格式

此 API 端点独特地同时支持 JSON 和 multipart/form-data 请求体，允许你轻松上传参考图片文件，而无需进行繁琐的 base64 编码。

请求参数

prompt (String, 必填)

所需图像的文本描述。最大长度：3000字符。

model (String, 必填)

要使用的图像生成模型。

image (File/URL, 选填)

用于图生图的参考图片。当使用 multipart/form-data 时，可以直接上传文件（Blob）。

aspect_ratio (String, 选填)

生成图像的比例（例如 16:9, 1:1）。

提示词长度限制
为了防止资源消耗和滥用，超过 3000 个字符的提示词将被拒绝，并返回 400 Bad Request 错误（错误码：prompt_too_long）。

请求示例

curl -X POST "https://qxan.net/api/ai/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "赛博朋克城市上空美丽的日落",
"model": "runninghub-i2i-v1",
"image": ["https://example.com/path/to/reference.jpg"],
"aspect_ratio": "16:9"
}'

curl -X POST "https://qxan.net/api/ai/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=赛博朋克城市上空美丽的日落" \
-F "model=runninghub-i2i-v1" \
-F "image=@/path/to/reference.jpg"

const formData = new FormData();
formData.append("prompt", "赛博朋克城市上空美丽的日落");
formData.append("model", "runninghub-i2i-v1");
formData.append("image", fileInput.files[0]); // 直接上传文件

const response = await fetch('https://qxan.net/api/ai/images/generations', {
method: 'POST',
headers: {
'Authorization': \`Bearer YOUR_API_KEY\`
},
body: formData // 注意：使用 FormData 时，请勿手动设置 Content-Type 请求头
});

const data = await response.json();
console.log(data);

响应示例

由于此接口为同步接口，请求会保持阻塞直到图像生成完毕，并直接返回包含最终图片 URL 的结果数组。

{
  "created": 1776403558,
  "data": [
    {
      "url": "https://rh-images.xiaoyaoyou.com/1fed4ce62b6a35e17d9103980f90ef6a/output/ComfyUI_00001_veioc_1776403543.png"
    }
  ]
}