跳转到主要内容
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 张参考图片,可用于风格/角色一致性控制