OneKey Gateway x agtm 给你的Agent安装Nano Banana生图3D渲染模型API

rockingdingo

368人浏览 · 2026-03-22 16:53:05

rockingdingo · 2026-03-22 16:53:05 发布

这篇博客给大家介绍如何给自己的Agent安装OneKey Gateway的Skills，用1个Access Key 来解锁使用超过30+需要验证付费的商用API，比如用 Gemini Nano Banana绘图、google-maps查找地图和导航、3D的prompt-to-3D Lego/minecraft 拼装模型等等，让你的个人agent 能力提升拉满。OneKey Gateway是MCP/Agent/LLM的一个统一网关层中间件，支持命令行cli和skills来访问众多API，以一个统一的Access Key 来验证，通过聚合API层支持多种类型Endpoint 链接，如MCP/Skills/Agent API等等。这篇教程我们利用 agtm命令行cli的提示词能力来帮助安装、下载和使用OneKey Gateway，避免记住不命令行的尴尬。当用户无法记住所有工具的复杂并且完整 CLI 命令、位置参数或选项，例如 playwright-cli、claude 或 codex、onekey等等。

GitHub 代码库欢迎收藏，提交更多API ：

https://github.com/aiagenta2z/onekey-gateway

https://github.com/aiagenta2z/agtm

目前支持的 Agent的API有搜索，地图，金融，图片生成，3D生成详细列表。

文档 | 在线使用Playground

OneKey - Gemini Nano Banana 出图

Craftsman Agent 文本转 3D 乐高组装图API

1. agtm 下载OneKey Gateway的Skills

首先，我们先利用agtm把 OneKey Gateway的Skills下载到本地目录，并且安装命令行执行

安装和设置

npm install -g @aiagenta2z/agtm            ## 安装 agtm的 skills包管理和 hint 命令行
npm install -g @aiagenta2z/onekey-gateway  ## 安装 onekey agent网关命令行

agtm 包管理设置

npx agtm setup --hint  # Builds a local RAG of CLI hints

# npx agtm run <provider_unique_id> <agent_cli>

下载Skills

npx agtm skills add aiagenta2z/onekey-gateway

下载Skills 到本地项目目录日志

onekey 命令行使用例子

## Usage: 设置Key，可以先用Demo Key 跑通 
export DEEPNLP_ONEKEY_ROUTER_ACCESS=BETA_TEST_KEY_MAR_2026
npx onekey agent <unique_id> <api_id> <data_json>

## Example: 
npx onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
npx onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini '{"model":"gemini-2.5-flash-image", "prompt":"Generate a minecraft scene of steve fighting zombies in purple crystal fields."}'

unique_id: 路由服务唯一ID，通常是 owner_id/repo_id 格式，例如 gemini-nano-banana/gemini-nano-banana

api_id: 具体执行的API，例如 generate_image_gemini 文生图，generate_image_gemini_with_reference 多图参考生图，等等

data_json: 本地json文件，或者是单引号包裹的请求json。

2. 使用 OneKey Gateway

2.1 使用 Gemini Nano Banana 进行画图

2.1.1 使用命令方式可以通过agtm交互式提醒补全命令行

只用在 "agtm run" 之后加入 nano 提示，然后一步一步补全就好

agtm run nano

然后根据提示选择 "aiagenta2z/onekey-gateway" 这个skills，

根据需要选择画图，这里我们选择3，根据prompt来直接生图，或者是 1. 根据参考图url 来修改适合修改背景，调整人像的需求：

最终提示执行命令行补全之后为

model: 可以设置为

gemini-2.5-flash-image (Nano Banana 1)

gemini-3-pro-image-preview

gemini-3.1-flash-image-preview（Nano Banana 2）等等

onekey agent gemini-nano-banana/gemini-nano-banana generate_image_nano_banana '{"model": "gemini-2.5-flash-image", "prompt": "robot reading book", "aspect_ratio": "16:9", "image_size": "1K"}'

如果使用Demo key返回数据格式

{"success":true,"data":{"image_url":"https://images.aiagenta2z.com/demo.png","message":"Image generated"},"message":"Input OneKey is Demo key Return Mock results. Please visit DeepNLP x AI Agent A2Z to acquire OneKey Access Key"}

2.1.2 直接使用完整OneKey 命令行调用Gemini Nano banana

这里 gemini-nano-banana/gemini-nano-banana 是 <unique_id>, generate_image_nano_banana 是希望执行的函数

后面是图片生成的入参：

prompt: 文本

model: Nano Banana的模型代号

onekey agent gemini-nano-banana/gemini-nano-banana generate_image_nano_banana '{"model": "gemini-2.5-flash-image", "prompt": "robot reading book", "aspect_ratio": "16:9", "image_size": "1K"}'

真实使用可以在线上申请，Access Key 有免费Credit额度

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

然后onekey gateway返回Gemini的结果里面获得生图的URL了比如

目前支持的 Agent的API有搜索，地图，金融，图片生成，3D生成详细列表参考： https://deepnlp.org/doc/onekey_gateway

2.2 使用 Google-Maps搜索地址

npx onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'

返回结果

{"success":true,"data":"[\"{\\n  \\\"places\\\": [\\n    {\\n      \\\"name\\\": \\\"Carmine's - Time Square\\\",\\n      \\\"formatted_address\\\": \\\"200 W 44th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.757498,\\n        \\\"lng\\\": -73.986654\\n      },\\n      \\\"place_id\\\": \\\"ChIJR9So-lRYwokRX1xEjA0rChA\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Osteria La Baia\\\",\\n      \\\"formatted_address\\\": \\\"129 W 52nd St, New York, NY 10019, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7618881,\\n        \\\"lng\\\": -73.9809702\\n      },\\n      \\\"place_id\\\": \\\"ChIJo9FTvDBZwokRFAZ0i4jbLuk\\\",\\n      \\\"rating\\\": 4.9,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Tony's Di Napoli\\\",\\n      \\\"formatted_address\\\": \\\"147 W 43rd St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7564842,\\n        \\\"lng\\\": -73.9853808\\n      },\\n      \\\"place_id\\\": \\\"ChIJVS2qI1VYwokRFo18YsKvHYM\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Lanterna di Vittorio\\\",\\n      \\\"formatted_address\\\": \\\"129 MacDougal St, New York, NY 10012, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7306651,\\n        \\\"lng\\\": -74.0000496\\n      },\\n      \\\"place_id\\\": \\\"ChIJPxCEeZFZwokRzk5UghlXZWU\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"cafe\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"night_club\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\",\\n        \\\"store\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Scarpetta\\\",\\n      \\\"formatted_address\\\": \\\"88 Madison Ave, New York, NY 10016, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.74458180000001,\\n        \\\"lng\\\": -73.9856202\\n      },\\n      \\\"place_id\\\": \\\"ChIJt8W7n79ZwokRsyXs3QDbE3o\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Osteria Nonnino\\\",\\n      \\\"formatted_address\\\": \\\"637 Hudson St, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7388972,\\n        \\\"lng\\\": -74.0057401\\n      },\\n      \\\"place_id\\\": \\\"ChIJu3WF-z9ZwokRSIlFddmXX1k\\\",\\n      \\\"rating\\\": 4.8,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"OLIO E PIÙ\\\",\\n      \\\"formatted_address\\\": \\\"3 Greenwich Ave, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7338208,\\n        \\\"lng\\\": -73.99979309999999\\n      },\\n      \\\"place_id\\\": \\\"ChIJ_RUJvZZZwokRNUEv3K4nSik\\\",\\n      \\\"rating\\\": 4.7,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Pecora Bianca SoHo\\\",\\n      \\\"formatted_address\\\": \\\"54 Prince St, New York, NY 10012, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.72346,\\n        \\\"lng\\\": -73.9963118\\n      },\\n      \\\"place_id\\\": \\\"ChIJfe6ZYKFZwokR_mHm7GNoAxc\\\",\\n      \\\"rating\\\": 4.8,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Osteria Barocca\\\",\\n      \\\"formatted_address\\\": \\\"133 Mulberry St, New York, NY 10013, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7186467,\\n        \\\"lng\\\": -73.99792409999999\\n      },\\n      \\\"place_id\\\": \\\"ChIJK0YQvsRZwokR9r2ubFZRd7E\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Sicily Osteria\\\",\\n      \\\"formatted_address\\\": \\\"328-330 W 46th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7601601,\\n        \\\"lng\\\": -73.9891863\\n      },\\n      \\\"place_id\\\": \\\"ChIJ03krMjJZwokRYRF15upaCHw\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Pecora Bianca NoMad\\\",\\n      \\\"formatted_address\\\": \\\"1133 Broadway, New York, NY 10010, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7436754,\\n        \\\"lng\\\": -73.9891719\\n      },\\n      \\\"place_id\\\": \\\"ChIJPf0L06VZwokRD6L-7RV-7Yg\\\",\\n      \\\"rating\\\": 4.7,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Da Andrea Greenwich Village\\\",\\n      \\\"formatted_address\\\": \\\"35 W 13th St, New York, NY 10011, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7361918,\\n        \\\"lng\\\": -73.9958515\\n      },\\n      \\\"place_id\\\": \\\"ChIJS1uszZRZwokRbKPTzS6hnWM\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Via Carota\\\",\\n      \\\"formatted_address\\\": \\\"51 Grove St, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7331959,\\n        \\\"lng\\\": -74.00364940000001\\n      },\\n      \\\"place_id\\\": \\\"ChIJr7FOf5NZwokRu3CDYtzVmuQ\\\",\\n      \\\"rating\\\": 4.4,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Masseria Dei Vini\\\",\\n      \\\"formatted_address\\\": \\\"887 9th Ave, New York, NY 10019, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7684477,\\n        \\\"lng\\\": -73.9857048\\n      },\\n      \\\"place_id\\\": \\\"ChIJeVfr_FhYwokRVM1IjwyvQpE\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Masseria NY\\\",\\n      \\\"formatted_address\\\": \\\"235 W 48th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.76088499999999,\\n        \\\"lng\\\": -73.9863\\n      },\\n      \\\"place_id\\\": \\\"ChIJjfIegVZYwokRyqdwvzBC27s\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Zia Maria Little Italy\\\",\\n      \\\"formatted_address\\\": \\\"138 Mulberry St, New York, NY 10013, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7187113,\\n        \\\"lng\\\": -73.9975649\\n      },\\n      \\\"place_id\\\": \\\"ChIJm7QTo_lZwokRRnjGuJABJPQ\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\",\\n        \\\"store\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Piccola Cucina Osteria Siciliana\\\",\\n      \\\"formatted_address\\\": \\\"196 Spring St, New York, NY 10012, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7250308,\\n        \\\"lng\\\": -74.0032774\\n      },\\n      \\\"place_id\\\": \\\"ChIJowhlWYxZwokRgrvA8f_x8Es\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Trattoria Trecolori\\\",\\n      \\\"formatted_address\\\": \\\"254 W 47th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7599972,\\n        \\\"lng\\\": -73.9867421\\n      },\\n      \\\"place_id\\\": \\\"ChIJYepwLVRYwokRsvXclA3XFqo\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Don Angie\\\",\\n      \\\"formatted_address\\\": \\\"103 Greenwich Ave, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7378037,\\n        \\\"lng\\\": -74.00209389999999\\n      },\\n      \\\"place_id\\\": \\\"ChIJfxC19JVZwokRX2uKgQAL17c\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Casa D'Angelo New York\\\",\\n      \\\"formatted_address\\\": \\\"146 Mulberry St, New York, NY 10013, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7188063,\\n        \\\"lng\\\": -73.9972296\\n      },\\n      \\\"place_id\\\": \\\"ChIJCxhnSohZwokRxmUkfrQWLfs\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    }\\n  ]\\n}\"]","error":null}

3. OneKey Gateway支持部分的Agent的API列表

Domain	Unique Id	Skill ID	API ID
Map (Google)	google-maps/google-maps Doc	google-maps	maps_directions maps_distance_matrix maps_elevation maps_geocode maps_place_details maps_reverse_geocode maps_search_places
Map (Amap/Gaode Map)	amap-maps-streamableHTTP/amap-maps-streamableHTTP Doc	amap-maps-streamableHTTP	maps_around_search maps_direction_bicycling maps_direction_driving maps_direction_transit_integrated maps_direction_walking maps_distance maps_geo maps_ip_location maps_regeocode maps_schema_navi maps_schema_personal_map maps_schema_take_taxi maps_search_detail maps_text_search maps_weather
Map (Baidu)	baidu-maps-sse/baidu-maps-sse Doc	baidu-maps-sse	maps_directions maps_distance_matrix maps_elevation maps_geocode maps_place_details maps_reverse_geocode maps_search_places
Image Search	bing-image-search-mcp/bing-image-search-mcp Doc	bing-image-search-mcp	search_images search_images_batch
Web Search	brave-search/brave-search Doc	brave-search	brave_local_search brave_web_search
Web Search	google-search/google-search Doc	google-search	google_search
Web Search	tavily-remote-mcp/tavily-remote-mcp Doc	tavily-remote-mcp	tavily_crawl tavily_extract tavily_map tavily_research tavily_search
Web Crawl / Browser	firecrawl-mcp/firecrawl-mcp Doc	firecrawl-mcp	firecrawl_agent firecrawl_agent_status firecrawl_browser_create firecrawl_browser_delete firecrawl_browser_execute firecrawl_browser_list firecrawl_check_crawl_status firecrawl_crawl firecrawl_extract firecrawl_map firecrawl_scrape firecrawl_search
Image Generation	gemini/gemini Doc	gemini (Nano Banana)	generate_image_gemini generate_image_nano_banana generate_image_nano_banana_with_reference ocr_extract_text_from_image list_items_from_image
Image Generation	gemini-nano-banana/gemini-nano-banana Doc	gemini-nano-banana	generate_image_gemini generate_image_nano_banana generate_image_nano_banana_with_reference ocr_extract_text_from_image list_items_from_image
Charts	mcp-server-chart/mcp-server-chart Doc	mcp-server-chart	generate_area_chart generate_bar_chart generate_boxplot_chart generate_column_chart generate_district_map generate_dual_axes_chart generate_fishbone_diagram generate_flow_diagram generate_funnel_chart generate_histogram_chart generate_line_chart generate_liquid_chart generate_mind_map generate_network_graph generate_organization_chart generate_path_map generate_pie_chart generate_pin_map generate_radar_chart generate_sankey_chart generate_scatter_chart generate_spreadsheet generate_treemap_chart generate_venn_chart generate_violin_chart generate_waterfall_chart generate_word_cloud_chart
Research QA	perplexity/perplexity Doc	perplexity	perplexity_ask perplexity_reason perplexity_research perplexity_search
3D Generation	craftsman-agent/craftsman-agent Doc	craftsman-agent	generate_lego_build_plan generate_minecraft_build_plan