Nano Banana 2

接口列表

Base URL: https://01router.com/api/v1

鉴权

以 Bearer Token 方式发送 API Key，费用从 Key 所属账户的积分中扣除。

Authorization: Bearer sk_xxxxxxxxxxxxxxxx

请求体

input 字段

统一参数适用于所有供应商；部分供应商支持的取值范围更窄，可通过报价接口或 Playground 查看。

调用示例

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "provider": "fal",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  }
}'

# poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/<id> -H "Authorization: Bearer $API_KEY"

响应示例

传入模型 ID、统一输入参数，可选指定供应商 slug。接口立即返回任务 ID；同步类供应商的图片模型可能直接返回成功结果。

{
  "id": "gen_6f1c…",
  "object": "generation",
  "model": "nano-banana-2",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "…",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-23T08:00:00.000Z",
  "completed_at": null
}

获取结果

每隔几秒轮询，直到 status 为 succeeded 或 failed。输出链接由供应商托管，可能过期，请及时下载保存。

curl https://01router.com/api/v1/generations/gen_6f1c… -H "Authorization: Bearer $API_KEY"

{ "id": "gen_6f1c…", "model": "nano-banana-2", "status": "succeeded", "outputs": ["https://…"], … }

报价

请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。

curl https://01router.com/api/v1/quote -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2","input":{"prompt":"…","aspect_ratio":"1:1","resolution":"1K","num_images":1}}'