PixMind Docs
API 参考图片模型Nano Banana Pro

Nano Banana Pro 图片生成

通过 PixMind API 使用 Nano Banana Pro 生成和编辑图片。

生成或编辑图片,支持多语言文字渲染、结构化版式和多张视觉参考。

提供方

Google

模型 ID

nano-banana-pro

请求端点

POST /v1/generations

模型说明

  • 仅传入可公开访问的 reference_images URL。
  • size 分辨率档位会改变 API 计费价格。

请求参数

参数类型必填说明
modelstring

稳定的 PixMind 模型 ID,请使用 `nano-banana-pro`。

可选值: nano-banana-pro

promptstring

用于生成或编辑的自然语言指令。

sizestring

输出分辨率档位,该字段会影响请求价格。

可选值: 1K, 2K, 4K

默认值: 1K

aspect_ratiostring

期望输出画面比例。

可选值: 1:1, 16:9, 9:16, 4:3, 3:4

默认值: 1:1

reference_imagesstring[] (URI)

用于编辑、构图、主体或风格引导的参考图片 URL 数组。

callback_urlstring (URI)

接收任务终态事件的 HTTPS 地址;不填写时仍可使用轮询。

请求示例

cURL
curl https://aihub-admin.aimix.pro/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-pro",
  "prompt": "A multilingual product poster with clean information hierarchy",
  "size": "2K",
  "aspect_ratio": "4:3",
  "reference_images": [
    "https://example.com/product.jpg"
  ]
}'
JavaScript
const response = await fetch("https://aihub-admin.aimix.pro/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "nano-banana-pro",
  "prompt": "A multilingual product poster with clean information hierarchy",
  "size": "2K",
  "aspect_ratio": "4:3",
  "reference_images": [
    "https://example.com/product.jpg"
  ]
})
});

const task = await response.json();

任务受理响应

生成任务为异步处理。请保存响应中的 id,并轮询 GET /v1/generations/{id},直到任务进入终态。

202 Accepted
{
  "id": "img_01JXYZ...",
  "model": "nano-banana-pro",
  "status": "processing"
}

API 定价

配置价格
1K 输出$0.120 / image
2K 输出$0.160 / image
4K 输出$0.240 / image

API 使用 apiPlatform 角色独立计费,与 PixMind Studio 积分分开;任务受理响应中的价格快照是最终计费依据。