接入指南

选择图片规格与参考图

依据实时请求 schema 规划图片比例、分辨率、输出格式和参考输入，以 Nano Banana 2 为例组织可验收的任务。

从交付要求开始

制作产品卡片、社交图片或广告变体时，先写明裁切比例、文件格式与验收要求，再选模型。分辨率与宽高比解决不同问题：前者选择尺寸档位，后者定义画面形状。1k 之类标签不保证所有比例都对应同一组宽高像素。

Nano Banana 2 模型页已有计算器、示例、API 与规格，直接使用这些入口，不另维护一份可能过期的价格表。本指南解释操作流程，不是画质排名。

校验完整输入

查询 GET /v1/media-models，找到准确的 model，检查 request_schema。校验整个输入对象，包括必填项、枚举大小写、长度、参考素材数量及组合限制。字段出现在 properties 中，并不说明任意组合都有效；不要根据相邻型号或厂商名称推断能力。

Nano Banana 2 的任务包装如下。它是示意请求 JSON，不会自动调用；真正提交计费请求前，仍需用当前 schema 核对这些选项。

{
  "model": "nano-banana2",
  "input": {
    "prompt": "A simple studio product photograph of a ceramic cup on a neutral background",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "images": []
  }
}

有目的地选择格式与参考图

不需要透明背景的摄影类结果可以考虑 JPEG；只有模型接受对应枚举且交付流程需要时，才选 PNG 或 WebP。选择 PNG 本身不等于要求生成透明背景。检查实际返回文件，不根据扩展名或分辨率标签断定其属性。

编辑或参考图任务只使用有权使用的素材，并按模型接受的结构传入；不要在 URL 中嵌入凭据。将原始素材、提示词和输入参数一起保存，便于检查主体、文字、构图及比例是否符合要求。参考输入用于引导任务，不保证精确复现。

扩展变体前先验收样本

先对获批的小样本检查主体细节、文字、裁切和品牌要求，再扩展批量任务。排查问题时一次改一个输入。若结果在视觉上不符合要求，网络重试并不能解决创作问题，应调整提示词或规格，并将下一次生成视为新的预算内尝试。

图片生成先调用 POST /v1/tasks，再用 GET /v1/tasks/{id} 查询；已受理任务不是最终图片。继续阅读模型 API 指南、任务学习路径和批量预算。这些内容补充现有模型计算器，不代替账号实时价格。