Nano Banana 生成与编辑

模型与能力

• 模型 id: 以模型广场在售的图像生成模型为准（示例使用 your-image-model-id 占位）。
• 分辨率: 支持 1K、2K、4K 输出。
• 宽高比: 支持 10 种宽高比;OpenAI 兼容模式默认 1:1,可通过 size 参数调整。
• 特长: 复杂指令理解、高质量文本渲染、精细局部编辑。
• 调用方式: OpenAI 兼容 Images 接口(本文示例);也可通过 Gemini 原生格式调用，见「Gemini 原生格式」篇。

图像生成

接口兼容 OpenAI Images API,使用标准参数 model、prompt、n、size。

POST https://api.yomiapi.com/v1/images/generations

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.yomiapi.com/v1"
)

response = client.images.generate(
    model="your-image-model-id",
    prompt="清晨的日式咖啡馆,窗边一杯拉花咖啡,柔和自然光,胶片质感",
    n=1,
    size="1024x1024"
)
print(response.data[0].url)

cURL 示例

curl https://api.yomiapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-image-model-id",
    "prompt": "清晨的日式咖啡馆,窗边一杯拉花咖啡,柔和自然光,胶片质感",
    "n": 1,
    "size": "1024x1024"
  }'

图像编辑

编辑接口在原图基础上按提示词修改，支持以下能力:

• 局部编辑: 精确控制编辑区域，其余画面保持不变。
• 角度调整: 改变图像视角和拍摄角度。
• 焦点控制: 调整景深和焦点位置。
• 色彩调整: 修改色调、饱和度、亮度。
• 光照调整: 改变光源方向和强度。

POST https://api.yomiapi.com/v1/images/edits

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.yomiapi.com/v1"
)

response = client.images.edit(
    model="your-image-model-id",
    image=open("input.png", "rb"),
    prompt="将背景替换为黄昏的海边,保持人物姿态与光影关系不变"
)
print(response.data[0].url)

计费与成本

图像生成属于媒体类能力，计费方式与单价以模型广场与「用量统计」中的实际扣费为准。

使用建议

• 提示词中明确主体、风格与构图;需要画面中出现文字时，直接写出文字内容与摆放位置。
• 编辑任务一次只描述一处修改，多轮小步编辑比单轮大改更可控。
• 高分辨率输出耗时更长，批量任务建议先用快速版验证提示词，再用标准版出图。