跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
images
/
generations
curl --request POST \
  --url https://ai.kaiho.cc/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "赛博朋克风格的霓虹城市街道，雨后倒影",
    "size": "16:9",
    "n": 1
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
异步处理模式： 提交请求后返回任务 ID，请通过 查询任务状态 接口获取生成结果。生成的图片链接有效期为 24 小时，请及时保存。
curl --request POST \
  --url https://ai.kaiho.cc/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "赛博朋克风格的霓虹城市街道，雨后倒影",
    "size": "16:9",
    "n": 1
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}

​
认证方式

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
请求参数

​
model
string
默认值:"gemini-3-pro-image-preview"
必填
图像生成模型名称示例："gemini-3-pro-image-preview"
​
prompt
string
必填
图像生成的文字描述最大 1000 个字符
​
size
string
图像生成尺寸支持的比例：
  • 1:1 - 正方形
  • 2:3 - 竖版
  • 3:2 - 横版
  • 3:4 - 竖版 3:4
  • 4:3 - 横版 4:3
  • 4:5 - 竖版 4:5
  • 5:4 - 横版 5:4
  • 9:16 - 竖版全屏
  • 16:9 - 横版宽屏
  • 21:9 - 超宽屏
​
resolution
string
默认值:"1K"
输出图像分辨率支持的值：
  • 1K - 1K 分辨率（默认）
​
n
integer
生成图像的数量固定为 1⚠️ 注意： 必须输入纯数字（如 1），不要使用引号包裹
​
image_urls
array<url>
参考图像 URL 列表，用于图生图或图片编辑
  • 最多 14 张图片
  • 每张图片不超过 10MB
  • 支持格式：.jpeg、.jpg、.png、.webp

​
响应参数

​
code
string
响应状态码
  • success - 请求成功，任务已提交
​
data
string
任务 ID，格式为 task-wave{timestamp}{userId}{random}用于通过 查询任务状态 接口获取生成结果

​
注意事项

  1. 异步处理： 任务提交后异步处理，请通过 查询任务状态 获取生成结果
  2. 链接有效期： 生成的图片链接有效期为 24 小时，请及时下载保存
  3. 专业品质： Nano Banana Pro 基于 Gemini 3 Pro，生成质量更高，适合专业级图像创作
  4. 参考图片： 支持最多 14 张参考图片，可用于风格/角色一致性控制