跳转到内容
HiAPI Docs
HiAPI
中文
English 中文

Nano Banana

概览

Section titled “概览”
提供商Google
模型名称Nano-Banana
主要端点/v1/chat/completions
返回形式choices[0].message.content 中返回 Markdown 图片内容
典型能力文生图、自然语言编辑、角色一致性、多图融合

Nano Banana 是当前最稳的 Google 系列对话式生图模型，重点优势是响应快、提示词容错高，适合先做创意探索，再逐步细化。

适用场景

Section titled “适用场景”
  • 批量生成社交媒体素材和活动配图
  • 用自然语言修改已有创意方向
  • 需要较快出图速度的日常设计流程
  • 同一角色或主体的系列图探索

端点

Section titled “端点”
  • POST /v1/chat/completions
  • 推荐关闭流式输出："stream": false
  • 图片配置放在 extra_body.google.image_config

关键参数

Section titled “关键参数”
参数类型说明
modelstring固定为 Nano-Banana
messagesarray标准 Chat Completions 消息数组，提示词放在 user 消息里
extra_body.google.image_config.aspect_ratiostring例如 1:1、16:9、9:16、4:3
extra_body.google.image_config.image_sizestring常用 1K，兼顾速度和质量
streamboolean建议设为 false 方便直接读取完整结果

请求示例

Section titled “请求示例”
Terminal window
curl -X POST https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Nano-Banana",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "一只橘猫坐在窗边看雨，胶片摄影风格，暖色灯光"
      }
    ],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "1:1",
          "image_size": "1K"
        }
      }
    }
  }'

响应示例

Section titled “响应示例”
{
  "id": "chatcmpl-img-001",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![image](data:image/png;base64,iVBORw0KGgoAAA...)"
      },
      "finish_reason": "stop"
    }
  ]
}

异步与轮询

Section titled “异步与轮询”

Nano Banana 同步返回结果，不需要轮询任务状态。拿到 choices[0].message.content 后，直接解析其中的 Markdown 图片内容即可。

常见错误

Section titled “常见错误”
  • 400 Bad Request：messages 为空，或 aspect_ratio、image_size 值不受支持。
  • 401 Unauthorized：API Key 缺失或无效。
  • 429 Too Many Requests：并发或速率超限，建议退避重试。
  • 400 content_policy_violation：提示词触发内容安全策略。

定价说明

Section titled “定价说明”

Nano Banana 的实时价格与可用倍率以实时定价页为准。

下一步

Section titled “下一步”