Nano Banana Skill_内容创作 skill-PHP中文网

Nano Banana Skill

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

"空空如也"

Nano Banana Skill.

功能概述

Nano Banana Skill.是一项面向实际任务的技能，主要用于Nano Banana是谷歌为AI代理设计的前沿AI图像生成模型系列.；Monet AI统一API平台的一部分.；

核心要点

When to use.；
Un the help when:.；
Character at。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

Nano Banana 技能

Nano Banana 是 Google 推出的前沿 AI 图像生成模型系列，专为 AI 智能体（AI agents）设计，属于 Monet AI 统一 API 平台的一部分。

适用场景

在以下情况下使用该技能：

角色一致的图像系列：利用参考图像生成具有统一角色特征的图像
- nano-banana-1：最多支持 5 张参考图像以保障角色一致性
- nano-banana-1-pro：最多支持 14 张参考图像，输出分辨率达 1K–4K
- nano-banana-2：基于最新 Gemini 模型，支持极端宽高比
高分辨率输出：生成专业级图像，支持 1K、2K 或 4K 分辨率
超宽格式：生成全景图像，支持极端宽高比（如 21:9、8:1）
风格迁移：使用多张参考图像引导图像风格与角色表现

获取 API Key

访问 https://monet.vision 注册账户
登录后，前往 https://monet.vision/skills/keys 创建 API Key
在环境变量或代码中配置该 API Key

如尚未获得 API Key，请联系您的负责人在 monet.vision 申请。

快速入门

创建图像生成任务

curl -X POST https://monet.vision/api/v1/tasks/async 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -d '{
    "type": "image",
    "input": {
      "model": "nano-banana-1",
      "prompt": "A cute cat in a garden",
      "aspect_ratio": "16:9"
    },
    "idempotency_key": "unique-key-123"
  }'

⚠️ 重要提示：idempotency_key 为必填项。请使用唯一值（例如 UUID），以防止请求重试时重复创建任务。

响应示例：

{
  "id": "task_abc123",
  "status": "pending",
  "type": "image",
  "created_at": "2026-02-27T10:00:00Z"
}

获取任务状态与结果

任务处理为异步执行，您需轮询任务状态直至其变为 success 或 failed。推荐轮询间隔：5 秒。

curl https://monet.vision/api/v1/tasks/task_abc123 
  -H "Authorization: Bearer $MONET_API_KEY"

任务完成后的响应示例：

{
  "id": "task_abc123",
  "status": "success",
  "type": "image",
  "outputs": [
    {
      "model": "nano-banana-1",
      "status": "success",
      "progress": 100,
      "url": "https://files.monet.vision/..."
    }
  ],
  "created_at": "2026-02-27T10:00:00Z",
  "updated_at": "2026-02-27T10:01:30Z"
}

示例：轮询至任务完成

const TASK_ID = "task_abc123";
const MONET_API_KEY = process.env.MONET_API_KEY;

async function pollTask() {
  while (true) {
    const response = await fetch(
      `https://monet.vision/api/v1/tasks/${TASK_ID}`,
      {
        headers: {
          Authorization: `Bearer ${MONET_API_KEY}`,
        },
      },
    );

    const data = await response.json();
    const status = data.status;

    if (status === "success") {
      console.log("Task completed successfully!");
      console.log(JSON.stringify(data, null, 2));
      break;
    } else if (status === "failed") {
      console.log("Task failed!");
      console.log(JSON.stringify(data, null, 2));
      break;
    } else {
      console.log(`Task status: ${status}, waiting...`);
      await new Promise((resolve) => setTimeout(resolve, 5000));
    }
  }
}

pollTask();

支持的模型

nano-banana-1

nano-banana-1 — Google Nano Banana

超高角色一致性

🎯 适用场景：需保持角色外观一致的图像系列
📐 最多参考图像数：5 张

{
  model: "nano-banana-1",
  prompt: string,                // 必填
  images?: string[],             // 可选：最多 5 张参考图像
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "4:3" | "3:4" | "16:9" | "9:16"
}

nano-banana-1-pro

nano-banana-1-pro — Nano Banana Pro

Google 旗舰级图像生成模型

🎯 适用场景：专业级高质量图像生成
📐 最多参考图像数：14 张
🖥️ 分辨率：1K、2K、4K

{
  model: "nano-banana-1-pro",
  prompt: string,                // 必填
  images?: string[],             // 可选：最多 14 张参考图像
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "4:3" | "3:4" | "4:5" | "5:4" | "16:9" | "9:16" | "21:9",
  resolution?: "1K" | "2K" | "4K"
}

nano-banana-2

nano-banana-2 — Nano Banana 2

Google Gemini 最新模型

🎯 适用场景：采用最新技术实现高质量图像生成
📐 最多参考图像数：14 张
🖥️ 分辨率：1K、2K、4K
🌍 特性：支持超宽宽高比（含 8:1）

{
  model: "nano-banana-2",
  prompt: string,                // 必填
  images?: string[],             // 可选：最多 14 张参考图像
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "4:3" | "3:4" | "4:5" | "5:4" | "16:9" | "9:16" | "21:9" | "4:1" | "1:4" | "8:1" | "1:8",
  resolution?: "1K" | "2K" | "4K"
}

API 参考文档

创建任务（异步）

POST /api/v1/tasks/async — 创建异步任务，立即返回任务 ID。

请求示例：

curl -X POST https://monet.vision/api/v1/tasks/async 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -d '{
    "type": "image",
    "input": {
      "model": "nano-banana-1",
      "prompt": "A cute cat"
    },
    "idempotency_key": "unique-key-123"
  }'

⚠️ 重要提示：idempotency_key 为必填项。请使用唯一值（例如 UUID），以防止请求重试时重复创建任务。

响应示例：

{
  "id": "task_abc123",
  "status": "pending",
  "type": "image",
  "created_at": "2026-02-27T10:00:00Z"
}

创建任务（流式）

POST /api/v1/tasks/sync — 创建支持 SSE 流式传输的任务，等待任务完成并实时推送进度。

请求示例：

curl -X POST https://monet.vision/api/v1/tasks/sync 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -N 
  -d '{
    "type": "image",
    "input": {
      "model": "nano-banana-1",
      "prompt": "A cute cat"
    },
    "idempotency_key": "unique-key-123"
  }'

获取任务

GET /api/v1/tasks/{taskId} — 获取指定任务的状态与结果。

请求示例：

curl https://monet.vision/api/v1/tasks/task_abc123 
  -H "Authorization: Bearer $MONET_API_KEY"

响应示例：

{
  "id": "task_abc123",
  "status": "success",
  "type": "image",
  "outputs": [
    {
      "model": "nano-banana-1",
      "status": "success",
      "progress": 100,
      "url": "https://files.monet.vision/..."
    }
  ],
  "created_at": "2026-02-27T10:00:00Z",
  "updated_at": "2026-02-27T10:01:30Z"
}

列出任务

GET /api/v1/tasks/list — 分页列出任务列表。

请求示例：

curl "https://monet.vision/api/v1/tasks/list?page=1&pageSize=20" 
  -H "Authorization: Bearer $MONET_API_KEY"

响应示例：

{
  "tasks": [
    {
      "id": "task_abc123",
      "status": "success",
      "type": "image",
      "outputs": [
        {
          "model": "nano-banana-1",
          "status": "success",
          "progress": 100,
          "url": "https://files.monet.vision/..."
        }
      ],
      "created_at": "2026-02-27T10:00:00Z",
      "updated_at": "2026-02-27T10:01:30Z"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 100
}

上传文件

POST /api/v1/files — 上传文件以获取在线可访问 URL。

📁 文件存储：上传的文件将保留 24 小时，过期后自动删除。

请求示例：

curl -X POST https://monet.vision/api/v1/files 
  -H "Authorization: Bearer $MONET_API_KEY" 
  -F "file=@/path/to/your/image.jpg" 
  -v

响应示例：

{
  "id": "file_xyz789",
  "url": "...",
  "filename": "image.jpg",
  "size": 1048576,
  "content_type": "image/jpeg",
  "created_at": "2026-02-27T10:00:00Z"
}