> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Nano Banana 2 Lite

> Nano Banana 2 Lite 是 Google Nano Banana 系列中最快、最具成本效率的 Gemini Image 模型，适合低延迟 1K 图像生成、基于提示词的图像编辑和可规模化的创意生产。

## 模型说明

<Tip>
  使用 `google/nano-banana-2-lite` 可完成快速文生图和图生图工作流。

  如需转换输入图片或提供视觉参考，请传入 `img_urls`；纯文生图可不传该字段。
</Tip>

## 查询任务状态

提交任务后，请使用统一查询接口查看进度并获取结果：

<Card title="获取任务信息" icon="magnifying-glass" href="/zh/models/common/get-task-info">
  了解如何查询任务状态并获取生成结果
</Card>

<Tip>
  生产环境中，建议使用 `callback_url` 参数接收任务完成后的自动通知，而不是轮询状态接口。
</Tip>

## 相关资源

<CardGroup cols={2}>
  <Card title="模型概览" icon="store" href="/zh/models/quickstart">
    查看所有可用模型
  </Card>

  <Card title="通用 API" icon="gear" href="/zh/common-api/get-account-credits">
    查询账户剩余积分
  </Card>
</CardGroup>


## OpenAPI

````yaml zh/models/google/nano-banana-2-lite.json post /api/v1/client/job/CreateTask
openapi: 3.0.0
info:
  title: Google Nano Banana 2 Lite API
  description: crun.ai Nano Banana 2 Lite API 文档
  version: 1.0.0
  contact:
    name: Technical Support
    email: support@crun.ai
servers:
  - url: https://api.crun.ai
    description: API 服务器
security:
  - ApiKeyAuth: []
paths:
  /api/v1/client/job/CreateTask:
    post:
      summary: 使用 Google Nano Banana 2 Lite 生成图像
      operationId: google/nano-banana-2-lite
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              properties:
                model:
                  type: string
                  enum:
                    - google/nano-banana-2-lite
                  description: |-
                    用于生成的模型名称，必填。

                    - 支持 `google/nano-banana-2-lite`
                callback_url:
                  type: string
                  format: uri
                  description: |-
                    可选。用于接收任务完成通知的回调 URL。

                    - 生成完成后，系统会向该 URL POST 任务状态和结果
                    - 回调 payload 结构与任务状态查询接口返回的 `data` 对象一致
                    - 您的回调接口应支持接收包含结果的 JSON POST 请求
                    - 成功接收后应返回 HTTP 200 状态码
                  example: https://your-domain.com/api/callback
                input:
                  type: object
                  description: Google Nano Banana 2 Lite 文生图或图生图生成任务的输入参数。
                  properties:
                    prompt:
                      type: string
                      description: 描述要生成或编辑图像的文本提示词。最多支持 20,000 个字符。
                      minLength: 1
                      maxLength: 20000
                      example: >-
                        A clean product photo of a compact espresso machine on a
                        marble counter, morning light, realistic commercial
                        photography.
                    aspect_ratio:
                      type: string
                      description: 生成图像的宽高比。适用时可使用 `auto` 匹配输入图片。
                      enum:
                        - '1:1'
                        - '2:3'
                        - '3:2'
                        - '3:4'
                        - '4:3'
                        - '4:5'
                        - '5:4'
                        - '9:16'
                        - '16:9'
                        - '1:4'
                        - '4:1'
                        - '1:8'
                        - '8:1'
                        - '21:9'
                        - auto
                      default: '1:1'
                      example: '16:9'
                    img_urls:
                      type: array
                      description: 可选。输入图片 URL，可用于图生图、图像编辑或视觉参考。最多支持 10 张图片。
                      items:
                        type: string
                        format: uri
                      maxItems: 10
                      example:
                        - https://example.com/product.jpg
                        - https://example.com/style-reference.png
                  required:
                    - prompt
            example:
              model: google/nano-banana-2-lite
              callback_url: https://your-domain.com/api/callback
              input:
                prompt: >-
                  Turn the product into a bright studio hero image with soft
                  shadows and a clean white background.
                aspect_ratio: '16:9'
                img_urls:
                  - https://example.com/product.jpg
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          task_id:
                            type: string
                            description: 任务 ID，可用于通过任务详情接口查询任务状态
                            example: task_nano-banana-2-lite_12345678
              example:
                code: 200
                message: success
                data:
                  task_id: task_nano-banana-2-lite_12345678
        '422':
          description: 参数校验错误
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      errors:
                        type: array
                        description: 详细的参数校验错误信息
                        items:
                          type: string
                        example:
                          - >-
                            Value error, Invalid input for model
                            google/nano-banana-2-lite: aspect_ratio: Input
                            should be one of the supported aspect ratios
              example:
                code: 422
                message: Missing Params or Type Error
                errors:
                  - >-
                    Value error, Invalid input for model
                    google/nano-banana-2-lite: aspect_ratio: Input should be one
                    of the supported aspect ratios
        '500':
          $ref: '#/components/responses/Error'
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        code:
          type: integer
          enum:
            - 200
            - 401
            - 402
            - 404
            - 422
            - 429
            - 455
            - 500
            - 501
            - 505
          description: |-
            响应状态码

            - **200**：成功，请求已成功处理
            - **401**：未授权，身份验证凭证缺失或无效
            - **402**：积分不足，账户积分不足以执行本次操作
            - **404**：未找到，请求的资源或接口不存在
            - **422**：参数校验错误，请求参数未通过校验
            - **429**：触发速率限制，请求频率已超过当前资源限制
            - **455**：服务不可用，系统正在维护
            - **500**：服务器错误，处理请求时发生意外错误
            - **501**：生成失败，内容生成任务失败
            - **505**：功能已禁用，请求的功能当前不可用
        message:
          type: string
          description: 响应消息；失败时为错误说明
          example: success
  responses:
    Error:
      description: 服务器错误
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: |-
        所有 API 都需要通过 API Key 进行身份验证。

        获取 API Key：
        1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取您的 API Key

        使用方式：
        添加到请求头：

        x-api-key: YOUR_API_KEY

        注意：
        - 请妥善保管您的 API Key，不要与他人共享
        - 如果怀疑 API Key 已泄露，请立即在管理页面重置

````