PointAPI
AI 图像生成 API

Nano Banana Pro 4K API — 价格与接入

Nano Banana Pro 4K:AI 图像生成 API。通过 Point API 使用此模型时,请使用准确的模型 ID 和下方列出的参数。提交生成请求前,请核对所选参数对应的已公布价格。

模型 ID: nanobanano-pro-4k

未在公布的配置中启用

在调试工具中打开

API 价格(USD)

Creator −10% 价格比 Studio Creator 生成费用换算成美元后低 10%。仅通过 API 提供的模型采用独立 API 定价。请求或字符范围档位为对应设置的完整费用;每张图像或每秒单价需乘以数量或时长。仅明确标注的模型按 token 计费。缺失或过期价格表示不可用,并非免费。

此配置尚未公布价格

支持的 API 参数

Nano Banana Pro 4K — 支持的 API 参数
参数类型允许值
promptstring
必填
最小值 (minLength): 1
最大值 (maxLength): 32000
ratiostring
可选
允许值 ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"]
默认值 (default): "1:1"
stylestring
可选
允许值 ["standard", "realistic", "artistic", "anime", "cinematic"]
默认值 (default): "standard"
countinteger
可选
允许值 [1, 2, 4]
默认值 (default): 1
最小值 (minimum): 1
最大值 (maximum): 4
imagesarray
可选
最大项数 (maxItems): 4
items: {"format": "data-url", "type": "string"}
preserve_reference_identitiesboolean
可选
默认值 (default): false
capabilities
{
  "additionalProperties": false,
  "max_reference_images": 4
}

已公布的接口约定最多允许 4 张参考图像。请仅使用此模型文档列出的参考字段和角色;此数量限制不表示支持其他媒体类型。

接入此模型

Point API 使用自己的 REST JSON 接口约定,通过异步生成任务返回结果。请将 API 密钥保存在服务器端,而非公开的前端代码中。

  1. 调用 GET /v1/models,确认准确的模型 ID、支持的输入字段以及已公布的价格档位。
  2. 在控制台创建获准调用该模型的 API 密钥,并确认美元余额足以支付请求。
  3. 向 POST /v1/generations 发送 REST JSON,并携带 Authorization: Bearer 和 Idempotency-Key。重试同一操作时,只有请求体保持不变才能重复使用该键。
  4. 使用返回的同一个生成任务 ID 轮询 GET /v1/generations/{id}。请求异步执行;状态为 unknown 时,请继续查询该 ID,而不是创建新的付费任务。
POST https://pointgpt.io/v1/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: YOUR_UNIQUE_REQUEST_ID

{
  "model": "nanobanano-pro-4k",
  "input": {
    "prompt": "木桌上的陶瓷茶壶,柔和的晨光,简洁的背景。"
  }
}

首次响应只表示请求已被接受,不表示生成已完成。请通过同一任务 ID 查询状态和结果。支持的输出格式与媒体访问权限取决于模型和账户权限。

API 文档

cURL / Python

POINT_API_KEY · POINT_REQUEST_ID

cURL

curl https://pointgpt.io/v1/generations \
  -H "Authorization: Bearer $POINT_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $POINT_REQUEST_ID" \
  --data-raw '{
  "model": "nanobanano-pro-4k",
  "input": {
    "prompt": "木桌上的陶瓷茶壶,柔和的晨光,简洁的背景。"
  }
}'

Python

import json
import os
from urllib.request import Request, urlopen

payload = json.loads('{\n  "model": "nanobanano-pro-4k",\n  "input": {\n    "prompt": "木桌上的陶瓷茶壶,柔和的晨光,简洁的背景。"\n  }\n}')
request = Request('https://pointgpt.io/v1/generations', method='POST',
    data=json.dumps(payload).encode('utf-8'),
    headers={
        'Authorization': 'Bearer ' + os.environ['POINT_API_KEY'],
        'Content-Type': 'application/json',
        'Idempotency-Key': os.environ['POINT_REQUEST_ID'],
    })
with urlopen(request, timeout=60) as response:
    job = json.load(response)
print(job['id'])

API 常见问题

API 请求如何计费?

Creator −10% 价格比 Studio Creator 生成费用换算成美元后低 10%。仅通过 API 提供的模型采用独立 API 定价。请求或字符范围档位为对应设置的完整费用;每张图像或每秒单价需乘以数量或时长。仅明确标注的模型按 token 计费。缺失或过期价格表示不可用,并非免费。 请求获接受时价格即固定。

可以使用兼容 OpenAI 的客户端或流式响应吗?

请按照文档接入 Point API 的 REST JSON 端点。此接口约定未声明提供 OpenAI 兼容端点或流式响应。请使用 API 文档中的请求与响应格式。

如何获取生成结果?

提交请求后会创建异步生成任务。保存任务 ID,并轮询 GET /v1/generations/{id} 获取状态和结果。unknown 状态并不表示应该重新提交;请继续查询原来的 ID。

相关模型