跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
images
/
generations
curl https://ai.kaiho.cc/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "超写实风格的海边日落全景",
    "size": "21:9",
    "resolution": "4K",
    "google_search_enhancement": true
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
本接口采用异步工作模式。成功提交请求后，系统将返回一个任务 ID (task_id)。您需要使用该 ID 调用查询接口获取生成结果。生成的图片链接有效期为 24 小时，请尽快下载保存。查询任务状态
curl https://ai.kaiho.cc/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "超写实风格的海边日落全景",
    "size": "21:9",
    "resolution": "4K",
    "google_search_enhancement": true
  }'

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

​
认证方式

​
Authorization
string
必填
API 密钥，格式为 Bearer YOUR_API_KEY。您可以在 控制台 获取您的 API Key。

​
请求参数

​
model
string
必填
模型 ID，固定为 gemini-3.1-flash-image-preview。
​
prompt
string
必填
图像生成的文本描述，最大长度 1000 字符。
​
size
string
默认值:"1:1"
生成图像的比例。支持常规及极端比例。 可选值：1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1
​
resolution
string
默认值:"1K"
生成分辨率。可选值：1K, 2K, 4K。
​
image_urls
array
参考图像 URL 数组，最大支持 14 张图片，用于风格或角色一致性。
​
google_search_enhancement
boolean
默认值:"false"
是否启用谷歌搜索增强，以提高生成内容的真实性。
​
n
number
默认值:"1"
生成数量，目前固定为 1。

​
响应参数

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

​
注意事项

  • 支持最高 4K 分辨率的高清图像输出。
  • 模型支持极端宽高比（如 1:8 或 8:1），适用于全景图或长条形设计。
  • 通过 image_urls 传入多达 14 张参考图，可以实现极佳的角色或风格一致性。