跳转到主要内容
POST
/
kyyAiPower
/
v1
/
banana
/
images
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/banana/images \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "nano-banana-2",
    "prompt": "一只可爱的橙色猫咪坐在窗台上看着外面的风景",
    "resolution": "2k",
    "size": "16:9",
    "image_urls": []
  }'

{
  "id": "abc123def456",
  "object": "image",
  "created": 1761635478,
  "model": "navobanana",
  "status": "queued"
}

​
创建图片生成任务

使用 Navo Banana API 创建高质量的 AI 图片生成任务，支持多种模型和分辨率选项。

​
认证

所有请求都需要在请求头中包含 Bearer token： 
Authorization: Bearer {{key}}

​
请求参数

​
model
string
必填
模型名称，可选值：
  • nano-banana-fast
  • nano-banana-pro
  • nano-banana-2
​
prompt
string
必填
图片生成提示词示例："一只可爱的橙色猫咪坐在窗台上看着外面的风景"
​
resolution
string
分辨率设置，仅 nano-banana-2 和 nano-banana-pro 支持可选值：
  • 1k - 1K 分辨率
  • 2k - 2K 分辨率
  • 4k - 4K 分辨率
​
size
string
宽高比设置可选值：
  • 1:1 - 正方形
  • 16:9 - 横屏宽屏
  • 9:16 - 竖屏
  • 4:3 - 标准横屏
  • 3:4 - 标准竖屏
  • 3:2 - 经典横屏
  • 2:3 - 经典竖屏
  • 5:4 - 略宽横屏
  • 4:5 - 略高竖屏
  • 21:9 - 超宽屏
​
image_urls
array
参考图片URL数组，用于指导图片生成风格

​
响应参数

​
id
string
图片生成任务的唯一标识符，用于后续查询任务状态
​
object
string
对象类型，固定为 navobanana
​
created
integer
任务创建时间戳
​
model
string
使用的模型名称
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
​
error
string
错误信息，当 status 为 failed 时返回

​
模型特性

nano-banana-fast

基础模型，快速生成，适合一般用途

nano-banana-2

增强模型，支持分辨率设置，质量更高

nano-banana-pro

专业版模型，最高质量，支持 4K 分辨率

​
注意事项

重要提示：
  • 图片生成为异步处理，需要通过返回的 id 查询任务状态和结果
  • resolution 参数仅在使用 nano-banana-2 或 nano-banana-pro 模型时有效
  • 建议轮询间隔为 2-5 秒，避免频繁请求
最佳实践：
  1. 使用 application/json 格式发送请求
  2. 提示词应该清晰描述所需的图片内容和风格
  3. 参考图片可以帮助指导生成风格，但不是必需的
  4. 选择合适的宽高比以匹配你的使用场景
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/banana/images \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "nano-banana-2",
    "prompt": "一只可爱的橙色猫咪坐在窗台上看着外面的风景",
    "resolution": "2k",
    "size": "16:9",
    "image_urls": []
  }'

{
  "id": "abc123def456",
  "object": "image",
  "created": 1761635478,
  "model": "navobanana",
  "status": "queued"
}