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

Nano Banana 2

概览

Section titled “概览”
提供商Google
模型名称Nano-Banana-2
主要端点/v1/chat/completions
返回形式choices[0].message.content 中返回 Markdown 图片内容
典型能力快速高质量出图、角色一致性、营销素材、批量创意迭代

Nano Banana 2 是 Nano Banana 系列里更偏向生产使用的一档，适合在速度和成片质量之间找平衡。

适用场景

Section titled “适用场景”
  • 规模化生成营销图和品牌素材
  • 系列封面图、社媒配图、A/B 测试物料
  • 需要兼顾响应速度和细节表现的场景
  • 同一创意方向下的多版本快速迭代

端点

Section titled “端点”
  • POST /v1/chat/completions
  • 建议 stream: false

关键参数

Section titled “关键参数”
参数类型说明
modelstring固定为 Nano-Banana-2
messagesarray提示词放在 user 消息中
extra_body.google.image_config.aspect_ratiostring常用 1:1、16:9、9:16
extra_body.google.image_config.image_sizestring常用 1K、2K
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-2",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "设计一张高端咖啡品牌社媒海报，主体是一杯冰滴咖啡，现代极简风格"
      }
    ],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "4:3",
          "image_size": "2K"
        }
      }
    }
  }'

响应示例

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

异步与轮询

Section titled “异步与轮询”

Nano Banana 2 同步返回结果，不需要轮询。

常见错误

Section titled “常见错误”
  • 400 Bad Request：image_size 或 aspect_ratio 取值错误。
  • 401 Unauthorized：API Key 无效。
  • 429 Too Many Requests：并发超限。
  • 400 content_policy_violation：提示词触发安全策略。

定价说明

Section titled “定价说明”

Nano Banana 2 的实时价格请查看实时定价页。部分规格会按质量倍率计费。

下一步

Section titled “下一步”