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

Nano Banana Pro

概览

Section titled “概览”
提供商Google
模型名称Nano-Banana-Pro
主要端点/v1/chat/completions
返回形式choices[0].message.content 中返回 Markdown 图片内容
典型能力高质量品牌图、精细文字排版、角色一致性、高分辨率输出

Nano Banana Pro 是 Nano Banana 系列的旗舰档，适合做更精细的商业成片和品牌素材。

适用场景

Section titled “适用场景”
  • 品牌主视觉、落地页头图、广告横幅
  • 需要更锐利细节的印刷级或大屏素材
  • 更强调文字渲染和角色一致性的项目
  • 重要活动或新品发布的高端视觉输出

端点

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

关键参数

Section titled “关键参数”
参数类型说明
modelstring固定为 Nano-Banana-Pro
messagesarray提示词放在 user 消息中
extra_body.google.image_config.aspect_ratiostring常用 1:1、16:9、9:16、3:4
extra_body.google.image_config.image_sizestring常用 1K、2K、4K
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-Pro",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "生成一张高端智能手表发布海报，深色背景，金属质感细节，画面中包含简洁英文标题"
      }
    ],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "16:9",
          "image_size": "2K"
        }
      }
    }
  }'

响应示例

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

异步与轮询

Section titled “异步与轮询”

Nano Banana Pro 同步返回图片，不需要轮询。

常见错误

Section titled “常见错误”
  • 400 Bad Request：image_size 不支持，或消息结构不合法。
  • 401 Unauthorized：API Key 无效。
  • 429 Too Many Requests：高规格任务排队较多，建议退避重试。
  • 400 content_policy_violation：提示词触发安全策略。

定价说明

Section titled “定价说明”

Nano Banana Pro 的实时价格请查看实时定价页。不同分辨率可能采用不同倍率。

下一步

Section titled “下一步”