APIMPAPIMP
用户指南AI 接口图片接口视频接口公共接口

nano-banana-2

提交 nano-banana-2 异步图片生成任务,返回 task_id 后通过状态查询接口轮询。

POST
/api/generate/submit

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型名,固定为 nano-banana-2

prompt*string

图片描述(必填,非空)。

size?string

输出尺寸,支持宽高比、像素尺寸或 auto

image?string

单张参考图 URL(图生图 / 编辑)。

images?array<string>

多张参考图 URL,最多 14 张。

Itemsitems <= 14
n?integer

生成数量。

Range1 <= value <= 4
resolution?string

输出分辨率。

Value in"1K" | "2K" | "4K"
mask_url?string

编辑模式蒙版 URL(需配合 image)。

google_search?boolean

开启 Google 检索增强。

google_image_search?boolean

开启 Google 图片检索增强。

model_params?object

模型扩展参数。

[key: string]?any
callback_url?string

任务终态时由平台主动 POST 的 HTTPS 回调地址(可选)。

Formaturi
[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.apimp.ai/api/generate/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "nano-banana-2",    "prompt": "A cute orange tabby kitten on a wooden table"  }'
{
  "code": 200,
  "data": {
    "task_id": "task_EPaZiCmMQOaDS2pdcwIEtFEV1aWjuWb2",
    "status": "not_started",
    "created_time": "2026-06-27T09:08:50",
    "error_message": null
  }
}

{
  "code": 400,
  "error": {
    "message": "field `prompt` is required",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

这篇文档对您有帮助吗?

最后更新于