image-extender

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

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

开源 free 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1111

维护状态低维护

是否开源是

定价模式 free

项目数据

分类图像生成

开发团队boona13

所属国家

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

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

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 1111

30天Star增速

HF 下载量

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

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数7

使用教程

难度：入门约 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`

如何确认成功

终端显示开发服务器已启动，浏览器打开 http://localhost:3000 能看到界面并弹出 API Key 输入提示即成功。

常见问题

Q：没有 OpenRouter API Key 能用吗？

A：不能。应用通过 OpenRouter 调用 Gemini 图像模型生成扩展内容，需先在 openrouter.ai/keys 申请密钥并在首次加载时填入。

Q：API Key 会被上传到服务器吗？

A：不会。README 说明密钥保存在你的浏览器本地，除非在设置中清除，否则不会再次弹出提示。

Q：AI 扩展一次要花多少钱？

A：README 给出的参考价约为每次 Gemini 扩展 $0.03，使用的是 Nano Banana 2 Flash Image 模型。

Q：为什么扩展后的图片看不出拼接缝？

A：项目内置泊松融合（Poisson blending）管线，对原图与 AI 生成像素做融合处理，从而隐藏接缝。

Q：3000 端口被占用怎么办？

A：README 未给出改端口的方法，可先释放占用 3000 端口的进程，或参考 Next.js 官方方式调整 dev 端口。

注意事项

README 只提供了本地开发模式（npm run dev）的启动方式，未给出生产构建或 Docker 部署命令。
图片扩展默认每次增加当前维度的 38%（EXTENSION_PERCENT），可在 app/lib/app.ts 中调整。
应用包含 Extender、Parallax、Tiles、Sprites、Props 五个工作区，可在顶栏的胶囊按钮间切换。
密钥与费用均由用户自行承担，请勿把密钥提交到公开仓库。

核心亮点

泊松融合算法，扩展区域与原始图像过渡自然，无明显接缝
提供最佳三选一功能，用户可挑选最满意的扩展结果
基于 OpenRouter 调用 Gemini，无需直接配置复杂 API，开箱即用

不足之处

依赖外部 API（OpenRouter/Gemini），需要付费或配置密钥，无法完全本地化运行
文档/社区待观察

适用场景

为社交媒体图片扩展背景，适配不同平台比例
修复旧照片或截图的不完整边缘，补全画面
创意设计时扩展构图，为原图增加更多环境元素

替代项目

Outpainting with Stable Diffusion、Clipdrop's Uncrop、Photoshop Generative Fill

项目介绍

image-extender 是图像领域的开源项目，由 boona13 开发，是 2026 年新上线的项目。

在全站 13,109 个收录项目中，它的 GitHub 星标数（1,111）位列前 30%，在图像分类的 840 个项目里位列前 15%。

近 42 天，它的 GitHub 星标从 1,088 增加到 1,111，净增 23。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。MIT许可证，可自行部署，无内置付费机制。

它主要面向的使用场景是：为社交媒体图片扩展背景，适配不同平台比例。同类可对比的替代方案包括 Outpainting with Stable Diffusion、Clipdrop's Uncrop、Photoshop Generative Fill。

上一篇：pwa-asset-generator

下一篇：MLX_z-image