跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
images
/
generations
curl -X POST "https://ai.kaiho.cc/v1/images/generations" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "flux-2-pro",
       "prompt": "赛博朋克风格的未来城市夜景",
       "size": "16:9"
     }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
本接口采用异步模式。提交成功后将返回 task_id，您需要通过任务状态接口获取生成结果。生成结果的下载链接有效期为 24 小时。
curl -X POST "https://ai.kaiho.cc/v1/images/generations" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "flux-2-pro",
       "prompt": "赛博朋克风格的未来城市夜景",
       "size": "16:9"
     }'

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

​
认证方式

​
Authorization
string
必填
在 API Key 页面 获取您的密钥，并以 Bearer YOUR_API_KEY 的格式放入请求头中。

​
请求参数

​
model
string
必填
使用的模型 ID。可选值：flux-2-pro, flux-2-dev。
​
prompt
string
必填
图像生成的文本提示词。最大长度 1000 字符。
​
image_urls
array
参考图片 URL 数组。用于图生图模式。
​
size
string
默认值:"1:1"
生成图像的比例。可选值：1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9。

​
响应参数

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

​
注意事项

  • 接口返回 task_id 后，请前往 查询任务状态 页面了解如何获取最终图像。
  • 支持纯文本生图以及参考图生图模式。
  • 生成的下载链接具有时效性，请及时转存。