image-extender

上传图片，AI 一键向任意方向扩展，无缝融合

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署图像生成 🍴 复刻 135 🐛 待处理 1 👀 关注 3

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1119

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可自行部署，无内置付费机制。

项目预览

image-extender 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类图像生成

开发团队boona13

官网地址https://github.com/boona13/image-extender

GitHubhttps://github.com/boona13/image-extender

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，可自行部署，无内置付费机制。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,gemini,image-generation,nano-banana,nextjs,openrouter,outpainting,poisson-blending,tailwindcss,typescript

GitHub 星标★ 1119

上线时间2026-05-26 00:00:00

代码更新2026-05-31

仓库体积1.2 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数8

项目介绍

image-extender 是一个开源的 AI 图像扩展（Outpainting）Web 应用，能无缝地将任意图片向任意方向扩展。它通过 OpenRouter 调用 Gemini 模型生成扩展内容，并采用泊松融合（Poisson blending）技术消除拼接痕迹，同时提供最佳三选一的变体选择器，让用户获得更满意的结果。项目基于 Next.js 和 TypeScript 构建，界面简洁，部署简单。它解决了传统图像扩展工具操作复杂、结果生硬的问题，让普通用户也能轻松扩展图片背景、构图或修复不完整画面。核心能力包括多方向扩展、智能融合、变体选择，且完全开源，可自托管。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1119

技术标签

ai gemini image-generation nano-banana nextjs

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

Node.js 与 npm 环境（用于执行 npm install / npm run dev）
本地可用端口 3000
一个 OpenRouter API Key（在 openrouter.ai/keys 获取）
首次扩展约需 $0.03 的 OpenRouter 额度（Gemini Nano Banana 2 Flash Image）

安装与启动步骤

1克隆仓库

把 image-extender 源码下载到本地，命令会自动创建 image-extender 目录。
```
git clone https://github.com/boona13/image-extender.git
```
2进入项目目录

切换到刚克隆下来的项目根目录，后续命令都在这里执行。
```
cd image-extender
```
3安装依赖

按 package.json 安装 Next.js/TypeScript 等项目依赖，耗时取决于网络。
```
npm install
```
4启动开发服务

运行开发服务器，启动后监听本地 3000 端口，保持终端窗口不要关闭。
```
npm run dev
```
5打开应用页面

浏览器访问本地地址，首次加载会弹出 OpenRouter API Key 输入框。
6填入 API Key

粘贴 OpenRouter 密钥，只保存在浏览器本地、不上传服务器；清除后需在设置里重填。

关键配置

配置项	必填	说明	示例
`EXTENSION_PERCENT`	否	每次扩展在当前维度上增加的百分比，位于 app/lib/app.ts。	`38`
`maxAttempts`	否	水平扩展时每个模型生成的最佳候选数量，位于 app/lib/models.ts。	`1`
`MAX_TILE_REVIEW_PASSES`	否	瓦片 QA 美术审核可额外触发的重绘次数，位于 app/page.tsx。	`2`
`TILESET_TILE_SIZE`	否	4×4 瓦片表里每个瓦片的像素分辨率。	`512`
`TILESET_ATLAS_EXTRUDE_PX`	否	导出图集时每个瓦片四周复制的边框像素宽度。	`2`
`PROP_BATCH`	否	每次点击添加时生成的道具数量，位于 app/lib/props.ts。	`8`