{
  "schemaVersion": "1.0",
  "item": {
    "slug": "morfeo-nano-banana-pro",
    "name": "Nano Banana Pro (Morfeo)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/PauldeLavallaz/morfeo-nano-banana-pro",
    "canonicalUrl": "https://clawhub.ai/PauldeLavallaz/morfeo-nano-banana-pro",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/morfeo-nano-banana-pro",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=morfeo-nano-banana-pro",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/generate_image.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/morfeo-nano-banana-pro"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/morfeo-nano-banana-pro",
    "agentPageUrl": "https://openagent3.xyz/skills/morfeo-nano-banana-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/morfeo-nano-banana-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/morfeo-nano-banana-pro/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Nano Banana Pro Image Generation & Editing",
        "body": "Generate new images or edit existing ones using Google's Nano Banana Pro API (Gemini 3 Pro Image)."
      },
      {
        "title": "Endpoints & Authentication",
        "body": "Google AI Studio (Public Preview):\n\nPOST https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent?key=${API_KEY}\n\nVertex AI (Enterprise):\n\nPOST https://${REGION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${REGION}/publishers/google/models/gemini-3-pro-image-preview:predict"
      },
      {
        "title": "Model IDs",
        "body": "API: gemini-3-pro-image-preview\nSDK interno: nanobanana-pro-001"
      },
      {
        "title": "Parameters",
        "body": "ParameterValuesDescriptionaspect_ratio1:1, 4:3, 3:4, 16:9, 9:16Output aspect ratiooutput_mime_typeimage/png, image/jpegOutput formatreference_imagesArray (max 14)Reference images for consistencyreference_typeCHARACTER, STYLE, SUBJECTHow to use referenceperson_generationALLOW_ADULT, DONT_ALLOW, FILTER_SENSITIVEPerson generation policyimage_size1K, 2K, 4KOutput resolution"
      },
      {
        "title": "Reference Types",
        "body": "STYLE: Transfer visual style, color palette, mood from reference\nCHARACTER: Maintain facial features, traits consistency across images\nSUBJECT: Keep the subject/product consistent (use for product photography!)"
      },
      {
        "title": "Advanced Capabilities",
        "body": "Text Rendering: Native text rendering without spelling errors\nIn-context Editing: Send existing image + modification prompt (automatic in-painting)\nHigh Resolution: Native upscale to 4K via upscale: true"
      },
      {
        "title": "Usage",
        "body": "Run the script using absolute path (do NOT cd to skill directory first):\n\nGenerate new image:\n\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"your image description\" \\\n  --filename \"output-name.png\" \\\n  [--resolution 1K|2K|4K] \\\n  [--api-key KEY]\n\nEdit existing image:\n\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"editing instructions\" \\\n  --filename \"output-name.png\" \\\n  --input-image \"path/to/input.png\" \\\n  [--resolution 1K|2K|4K]\n\nWith reference image (product/style/character consistency):\n\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"your description\" \\\n  --filename \"output-name.png\" \\\n  --reference-image \"path/to/reference.jpg\" \\\n  --reference-type SUBJECT|STYLE|CHARACTER \\\n  [--resolution 1K|2K|4K]\n\nImportant: Always run from the user's current working directory so images are saved where the user is working, not in the skill directory."
      },
      {
        "title": "Resolution Options",
        "body": "1K (default) - ~1024px resolution\n2K - ~2048px resolution (recommended for most uses)\n4K - ~4096px resolution (high quality)\n\nMap user requests:\n\nNo mention → 1K\n\"low resolution\", \"1080\", \"1080p\", \"1K\" → 1K\n\"2K\", \"2048\", \"normal\", \"medium resolution\" → 2K\n\"high resolution\", \"high-res\", \"hi-res\", \"4K\", \"ultra\" → 4K"
      },
      {
        "title": "API Key",
        "body": "The script checks for API key in this order:\n\n--api-key argument\nGEMINI_API_KEY environment variable"
      },
      {
        "title": "Filename Generation",
        "body": "Format: {timestamp}-{descriptive-name}.png\n\nTimestamp: yyyy-mm-dd-hh-mm-ss (24-hour format)\nName: Descriptive lowercase with hyphens\n\nExamples:\n\n2025-11-23-14-23-05-japanese-garden.png\n2025-11-23-15-30-12-sunset-mountains.png"
      },
      {
        "title": "Prompt Engineering Framework",
        "body": "You are an expert Prompt Engineer specializing in Nano Banana Pro. Transform basic user ideas and reference images into high-fidelity, descriptive prompts."
      },
      {
        "title": "1. Input Analysis",
        "body": "When provided with a user idea and reference images, evaluate:\n\nSubject Matter: Identify primary actors, objects, or focal points\nReference Utility: Determine if image provides composition (layout), style (aesthetic/texture), or character (specific features)\nText Requirements: Note any specific text to render within the image"
      },
      {
        "title": "2. Prompt Construction Framework",
        "body": "Structure optimized prompts using this hierarchy:"
      },
      {
        "title": "Core Subject & Action",
        "body": "Clear description of \"who\" or \"what\" is doing \"what.\""
      },
      {
        "title": "Style & Medium",
        "body": "Specify artistic medium:\n\nHyper-realistic photography\nOil painting\n3D render\nMinimalist vector\nCommercial food photography\nEditorial style"
      },
      {
        "title": "Reference Integration",
        "body": "Explicitly instruct on how to use uploaded images:\n\n\"Retain the product packaging from the reference image as the hero element\"\n\"Apply the warm lighting aesthetic from Reference A\""
      },
      {
        "title": "Technical Details",
        "body": "Lighting:\n\nCinematic rim lighting\nSoft diffused sunlight\nHarsh strobes\nWarm tungsten lighting\nGolden hour warmth\n\nComposition:\n\nWide-angle shot\nMacro detail\nBird's-eye view\nShallow depth of field\nProduct as hero element\n\nColor Theory:\n\nMonochromatic blue\nHigh-contrast complementary\nWarm amber tones\nDark moody palette\n\nText Rendering:\nUse double quotes for specific text:\n\n\"The word 'FUTURE' written in bold, brushed-metal 3D lettering across the center\""
      },
      {
        "title": "DO:",
        "body": "Use descriptive positive language\nExpand vague terms (\"cool\" → \"iridescent\", \"pretty\" → \"ethereal\", \"realistic\" → \"photorealistic 8k texture\")\nMaintain consistency with reference images\nUse powerful adjectives for mood (\"gritty,\" \"serene,\" \"industrial,\" \"whimsical\")\nSpecify \"8k texture detail\" or \"8k photorealistic detail\" for quality"
      },
      {
        "title": "DON'T:",
        "body": "Use negative prompts (say what you want, not what you don't)\nContradict visual data in reference images\nUse vague terms without expansion"
      },
      {
        "title": "4. Product Photography Best Practices",
        "body": "When generating images with products as protagonists:\n\nAlways use --reference-type SUBJECT to maintain product consistency\nDescribe the product prominently in the prompt:\n\n\"Milkaut Crematto container with blue label and red lid prominently displayed\"\n\n\nPosition product as hero element:\n\n\"the product container as co-star product placement\"\n\"product container in sharp focus\"\n\n\nInclude product in scene naturally:\n\n\"positioned next to\", \"beside\", \"prominently arranged\""
      },
      {
        "title": "Example Product Photography Prompt:",
        "body": "Hyper-realistic commercial food photography with a [PRODUCT NAME] container \nprominently displayed next to [FOOD ITEM], [food description], \n[setting/background], [lighting style], the [product] as hero element, \n8k photorealistic detail"
      },
      {
        "title": "5. Output Format",
        "body": "Provide the optimized prompt in English, without additional commentary."
      },
      {
        "title": "Product + Food Scene",
        "body": "uv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"Hyper-realistic commercial food photography with a Milkaut Crematto container prominently displayed next to a gourmet double smash burger with perfectly melted cheddar cheese cascading down juicy beef patties, artisan brioche bun, wisps of steam rising, dark moody background with dramatic rim lighting, the cream cheese container as hero product placement, 8k texture detail\" \\\n  --filename \"2026-01-28-product-burger.png\" \\\n  --reference-image \"product-photo.jpg\" \\\n  --reference-type SUBJECT \\\n  --resolution 2K"
      },
      {
        "title": "Style Transfer",
        "body": "uv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"Using the warm golden hour aesthetic from the reference, create a serene Japanese garden with cherry blossoms, koi pond reflecting soft pink petals, traditional wooden bridge, ethereal morning mist, 8k photorealistic detail\" \\\n  --filename \"2026-01-28-japanese-garden.png\" \\\n  --reference-image \"style-reference.jpg\" \\\n  --reference-type STYLE \\\n  --resolution 2K"
      },
      {
        "title": "Image Editing",
        "body": "uv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"Change the background to a dramatic sunset over mountains, maintain the subject in sharp focus\" \\\n  --filename \"2026-01-28-edited-sunset.png\" \\\n  --input-image \"original.jpg\" \\\n  --resolution 2K"
      }
    ],
    "body": "Nano Banana Pro Image Generation & Editing\n\nGenerate new images or edit existing ones using Google's Nano Banana Pro API (Gemini 3 Pro Image).\n\nAPI Technical Specification\nEndpoints & Authentication\n\nGoogle AI Studio (Public Preview):\n\nPOST https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent?key=${API_KEY}\n\n\nVertex AI (Enterprise):\n\nPOST https://${REGION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${REGION}/publishers/google/models/gemini-3-pro-image-preview:predict\n\nModel IDs\nAPI: gemini-3-pro-image-preview\nSDK interno: nanobanana-pro-001\nParameters\nParameter\tValues\tDescription\naspect_ratio\t1:1, 4:3, 3:4, 16:9, 9:16\tOutput aspect ratio\noutput_mime_type\timage/png, image/jpeg\tOutput format\nreference_images\tArray (max 14)\tReference images for consistency\nreference_type\tCHARACTER, STYLE, SUBJECT\tHow to use reference\nperson_generation\tALLOW_ADULT, DONT_ALLOW, FILTER_SENSITIVE\tPerson generation policy\nimage_size\t1K, 2K, 4K\tOutput resolution\nReference Types\nSTYLE: Transfer visual style, color palette, mood from reference\nCHARACTER: Maintain facial features, traits consistency across images\nSUBJECT: Keep the subject/product consistent (use for product photography!)\nAdvanced Capabilities\nText Rendering: Native text rendering without spelling errors\nIn-context Editing: Send existing image + modification prompt (automatic in-painting)\nHigh Resolution: Native upscale to 4K via upscale: true\nUsage\n\nRun the script using absolute path (do NOT cd to skill directory first):\n\nGenerate new image:\n\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"your image description\" \\\n  --filename \"output-name.png\" \\\n  [--resolution 1K|2K|4K] \\\n  [--api-key KEY]\n\n\nEdit existing image:\n\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"editing instructions\" \\\n  --filename \"output-name.png\" \\\n  --input-image \"path/to/input.png\" \\\n  [--resolution 1K|2K|4K]\n\n\nWith reference image (product/style/character consistency):\n\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"your description\" \\\n  --filename \"output-name.png\" \\\n  --reference-image \"path/to/reference.jpg\" \\\n  --reference-type SUBJECT|STYLE|CHARACTER \\\n  [--resolution 1K|2K|4K]\n\n\nImportant: Always run from the user's current working directory so images are saved where the user is working, not in the skill directory.\n\nResolution Options\n1K (default) - ~1024px resolution\n2K - ~2048px resolution (recommended for most uses)\n4K - ~4096px resolution (high quality)\n\nMap user requests:\n\nNo mention → 1K\n\"low resolution\", \"1080\", \"1080p\", \"1K\" → 1K\n\"2K\", \"2048\", \"normal\", \"medium resolution\" → 2K\n\"high resolution\", \"high-res\", \"hi-res\", \"4K\", \"ultra\" → 4K\nAPI Key\n\nThe script checks for API key in this order:\n\n--api-key argument\nGEMINI_API_KEY environment variable\nFilename Generation\n\nFormat: {timestamp}-{descriptive-name}.png\n\nTimestamp: yyyy-mm-dd-hh-mm-ss (24-hour format)\nName: Descriptive lowercase with hyphens\n\nExamples:\n\n2025-11-23-14-23-05-japanese-garden.png\n2025-11-23-15-30-12-sunset-mountains.png\nPrompt Engineering Framework\n\nYou are an expert Prompt Engineer specializing in Nano Banana Pro. Transform basic user ideas and reference images into high-fidelity, descriptive prompts.\n\n1. Input Analysis\n\nWhen provided with a user idea and reference images, evaluate:\n\nSubject Matter: Identify primary actors, objects, or focal points\nReference Utility: Determine if image provides composition (layout), style (aesthetic/texture), or character (specific features)\nText Requirements: Note any specific text to render within the image\n2. Prompt Construction Framework\n\nStructure optimized prompts using this hierarchy:\n\nCore Subject & Action\n\nClear description of \"who\" or \"what\" is doing \"what.\"\n\nStyle & Medium\n\nSpecify artistic medium:\n\nHyper-realistic photography\nOil painting\n3D render\nMinimalist vector\nCommercial food photography\nEditorial style\nReference Integration\n\nExplicitly instruct on how to use uploaded images:\n\n\"Retain the product packaging from the reference image as the hero element\" \"Apply the warm lighting aesthetic from Reference A\"\n\nTechnical Details\n\nLighting:\n\nCinematic rim lighting\nSoft diffused sunlight\nHarsh strobes\nWarm tungsten lighting\nGolden hour warmth\n\nComposition:\n\nWide-angle shot\nMacro detail\nBird's-eye view\nShallow depth of field\nProduct as hero element\n\nColor Theory:\n\nMonochromatic blue\nHigh-contrast complementary\nWarm amber tones\nDark moody palette\n\nText Rendering: Use double quotes for specific text:\n\n\"The word 'FUTURE' written in bold, brushed-metal 3D lettering across the center\"\n\n3. Optimization Rules\nDO:\nUse descriptive positive language\nExpand vague terms (\"cool\" → \"iridescent\", \"pretty\" → \"ethereal\", \"realistic\" → \"photorealistic 8k texture\")\nMaintain consistency with reference images\nUse powerful adjectives for mood (\"gritty,\" \"serene,\" \"industrial,\" \"whimsical\")\nSpecify \"8k texture detail\" or \"8k photorealistic detail\" for quality\nDON'T:\nUse negative prompts (say what you want, not what you don't)\nContradict visual data in reference images\nUse vague terms without expansion\n4. Product Photography Best Practices\n\nWhen generating images with products as protagonists:\n\nAlways use --reference-type SUBJECT to maintain product consistency\nDescribe the product prominently in the prompt:\n\n\"Milkaut Crematto container with blue label and red lid prominently displayed\"\n\nPosition product as hero element:\n\n\"the product container as co-star product placement\" \"product container in sharp focus\"\n\nInclude product in scene naturally:\n\n\"positioned next to\", \"beside\", \"prominently arranged\"\n\nExample Product Photography Prompt:\nHyper-realistic commercial food photography with a [PRODUCT NAME] container \nprominently displayed next to [FOOD ITEM], [food description], \n[setting/background], [lighting style], the [product] as hero element, \n8k photorealistic detail\n\n5. Output Format\n\nProvide the optimized prompt in English, without additional commentary.\n\nExamples\nProduct + Food Scene\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"Hyper-realistic commercial food photography with a Milkaut Crematto container prominently displayed next to a gourmet double smash burger with perfectly melted cheddar cheese cascading down juicy beef patties, artisan brioche bun, wisps of steam rising, dark moody background with dramatic rim lighting, the cream cheese container as hero product placement, 8k texture detail\" \\\n  --filename \"2026-01-28-product-burger.png\" \\\n  --reference-image \"product-photo.jpg\" \\\n  --reference-type SUBJECT \\\n  --resolution 2K\n\nStyle Transfer\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"Using the warm golden hour aesthetic from the reference, create a serene Japanese garden with cherry blossoms, koi pond reflecting soft pink petals, traditional wooden bridge, ethereal morning mist, 8k photorealistic detail\" \\\n  --filename \"2026-01-28-japanese-garden.png\" \\\n  --reference-image \"style-reference.jpg\" \\\n  --reference-type STYLE \\\n  --resolution 2K\n\nImage Editing\nuv run ~/.clawdbot/skills/nano-banana-pro/scripts/generate_image.py \\\n  --prompt \"Change the background to a dramatic sunset over mountains, maintain the subject in sharp focus\" \\\n  --filename \"2026-01-28-edited-sunset.png\" \\\n  --input-image \"original.jpg\" \\\n  --resolution 2K"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/PauldeLavallaz/morfeo-nano-banana-pro",
    "publisherUrl": "https://clawhub.ai/PauldeLavallaz/morfeo-nano-banana-pro",
    "owner": "PauldeLavallaz",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/morfeo-nano-banana-pro",
    "downloadUrl": "https://openagent3.xyz/downloads/morfeo-nano-banana-pro",
    "agentUrl": "https://openagent3.xyz/skills/morfeo-nano-banana-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/morfeo-nano-banana-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/morfeo-nano-banana-pro/agent.md"
  }
}