MediaIO Nano Banana Pro 图像生成技能

概述

该技能通过 Media.io OpenAPI 提供对 Nano Banana Pro 的访问能力。Nano Banana Pro 采用新一代多模态推理技术，可生成与精细概念描述高度契合的图像，具备业界领先的图像质量，并支持高级推理、多图融合及角色一致性。

触发关键词

当听到以下关键词时，请调用此技能：

• “Nano Banana Pro”、“Nano Banana Pro image generator”
• “Generate image with Nano Banana Pro”
• “Banana Pro AI image generation”

前提条件

环境变量

API 详情

Nano Banana Pro 图像生成

• API 名称: Nano Banana Pro
• 模型代码: i2i-banana-2
• 接口地址: POST https://openapi.media.io/generation/banana/i2i-banana-2
• 说明: 利用新一代多模态推理技术，生成与精细概念描述高度契合的图像。

核心特性

• 业界领先的图像质量
• 高级多模态推理能力
• 多图融合
• 角色一致性
• 最高支持 4K 分辨率
• 精准匹配精细的概念化描述

请求参数

通用响应结构

{
  "code": 0,
  "msg": "",
  "data": {
    "task_id": "..."
  },
  "trace_id": "..."
}

快速开始

1) 安装依赖

pip install requests

2) 初始化技能

import os
from scripts.skill_router import Skill

skill = Skill('scripts/c_api_doc_detail.json')
api_key = os.getenv('API_KEY', '')
if not api_key:
    raise RuntimeError('API_KEY is not set')

3) 配置环境变量 API_KEY

Windows PowerShell：

$env:API_KEY="your-api-key"

macOS / Linux（bash/zsh）：

export API_KEY="your-api-key"

使用示例（Python）

高质量图像生成

import os
from scripts.skill_router import Skill

skill = Skill('scripts/c_api_doc_detail.json')
api_key = os.getenv('API_KEY', '')
if not api_key:
    raise RuntimeError('API_KEY is not set')

result = skill.invoke(
    'Nano Banana Pro',
    {
        'prompt': 'a serene mountain landscape at sunset, photorealistic, 4K quality, dramatic lighting',
        'ratio': '16:9'
    },
    api_key=api_key
)
print(result)  # 当 code=0 时返回 task_id

多图融合

import os
from scripts.skill_router import Skill

skill = Skill('scripts/c_api_doc_detail.json')
api_key = os.getenv('API_KEY', '')
if not api_key:
    raise RuntimeError('API_KEY is not set')

result = skill.invoke(
    'Nano Banana Pro',
    {
        'prompt': 'a futuristic cityscape combining classical and modern architecture',
        'image': 'https://example.com/reference-image.jpg',
        'fusion_strength': '0.7'
    },
    api_key=api_key
)
print(result)

查询任务结果

import os
import time
from scripts.skill_router import Skill

skill = Skill('scripts/c_api_doc_detail.json')
api_key = os.getenv('API_KEY', '')
if not api_key:
    raise RuntimeError('API_KEY is not set')

task_id = 'your-task-id'

for _ in range(24):
    r = skill.invoke('Task Result', {'task_id': task_id}, api_key=api_key)
    print(r)
    status = (r.get('data') or {}).get('status')
    if status in ('completed', 'failed', 'succeeded'):
        break
    time.sleep(5)

任务状态说明

• waiting: 已入队列
• processing: 执行中
• completed: 成功完成
• failed: 执行失败
• timeout: 超时

错误处理

外部资源

• API 文档：https://platform.media.io/docs/
• 产品概览：https://developer.media.io/
• 积分购买：https://developer.media.io/pricing.html

相关文件

• scripts/skill_router.py：核心路由逻辑
• scripts/c_api_doc_detail.json：API 定义