生成图片
POST /api/v1/image/nano-banana,支持文生图与图生图;上传参考图时使用 multipart/form-data。
方法: POST路径: /api/v1/image/nano-banana
请求体字段
- prompt(必填):生成描述。
- model(必填):nano-banana-fast | nano-banana | nano-banana-pro | nano-banana-vip | nano-banana-pro-vip。
- mode(选填):text-to-image(默认)或 image-to-image,图生图至少需 1 张参考图。
- aspectRatio(选填):默认 auto,可传 1:1、16:9、9:16 等。
- imageSize(选填):默认 1K,可传 1K/2K/4K。
- outputFormat(选填):默认 png。
- isPublic(选填):默认 true。
- imageFile(选填,FormData):图生图参考文件,最多 8 张,单张 <=10 MB。
- imageUrl(选填):参考图直链,字符串或字符串数组,计入 8 张上限。
- imageData(选填,兼容):仍接受 base64 data URL,但推荐用 FormData 上传文件以避免体积过大。
失败返回:400:缺少必填参数 / 图生图无参考图 / 模型无效 / 参考图数量超限。;401:未登录。;402:积分不足。;500:服务配置异常或下游错误。
示例请求
curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana \
-H "Authorization: Bearer api-key" \
-F "prompt=一只穿宇航服的香蕉猫在月球" \
-F "model=nano-banana-pro-vip" \
-F "mode=image-to-image" \
-F "aspectRatio=auto" \
-F "imageSize=1K" \
-F "outputFormat=png" \
-F "isPublic=true" \
-F "imageFile=@/path/to/ref.png" \
-F "imageUrl=https://example.com/ref2.png"示例响应
{
"code": 0,
"message": "ok",
"data": {
"id": "task-id-xxx",
"results": [],
"progress": 0,
"status": "running",
"failure_reason": null,
"error": null,
"credits_cost": 40
}
}