跳转到主要内容
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-2nano-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-2nano-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"
}