AI 扩图 API ： 把任意图片扩成新的画面比例
给它一张图，选一个比例。AI 会把原图缩小放在新画面的中间，四周补画出完整的场景，返回一张 PNG。先在这里在线扩图，满意后用一个 API Key、一份余额，把同一个模型接进你的产品。
- 一张图片
- 10 种比例或自动
- 每次固定价
- 同一个模型，API 直接调
功能亮点
AI 扩图 API 的核心能力
10 种比例，外加 auto
每个任务可选 1:1、3:2、2:3、4:3、3:4、4:5、5:4、9:16、16:9、21:9；也可以选 auto，自动从这 10 种里挑和原图形状最接近的一种。
真正的扩图，不是加一圈边
原图会被缩小，放在新画面的正中，模型把四周整片画出来：更多天空、更多地面、更开阔的空间，而不是只在边上补一条。
横图转竖图，竖图转横图
横拍的照片扩成 9:16 的竖屏，竖拍的扩成 16:9 的横幅，或者统一扩成 1:1 的方图，主体一点都不用裁掉。
不用写提示词
请求里只有 image_url 和 aspect_ratio 两个参数。画面外面应该是什么，由模型看图自己判断，不需要你来描述。
高分辨率 PNG
结果是 PNG，尺寸由模型按所选比例决定，例如 16:9 是 2752×1536；另外还有一张长边不超过 1024 像素的 JPEG 预览图。
一分钟左右出图
从创建任务到拿到结果约 1–1.5 分钟。不论选哪种比例，都是同一个固定价。
简介
什么是 AI 扩图 API？
- 模型 ID
outpaint-image- 素材
- 一张图片
- 画面比例
- 11 种
- 价格
- 每次 $0.0936
扩图和裁图正好相反：裁图是把画面裁成新的比例，扩图是让 AI 往外画，把原图边框之外可能有的内容补出来。AI 扩图 API 把这件事做成了一个 HTTP 接口：传一张图和目标比例，拿回一张更宽或更高、原图就在其中的新图。
在 NanoAPI 上，它是产品 outpaint_image 下的模型 outpaint-image。原图会先缩小、放在新画面的正中，模型再顺着原来的场景把四周画满。所以一张 4:3 的照片扩成 16:9 或 21:9 之后，是一个真正更开阔的画面，而不是在原图边上拉伸出一条。
因为不需要提示词，AI 扩图很适合放进自动化流程：每个任务就是一个 image_url 加一个 aspect_ratio，只出一张 PNG，价格固定。它和 NanoAPI 的其他模型一样走 POST /v1/tasks 接口，用同一个 API Key 和同一份预付余额，任务失败全额退回。
你可以先在本页顶部的工作台在线扩图，再在自己的应用里通过 https://api.nanoapi.ai/v1 调用 AI 扩图 API。两边是同一个模型、同样的价格，你在这里试出来的效果，就是用户拿到的效果。
价格
AI 扩图 API 价格
每次固定价：选哪种比例、原图多大都不影响价格，任务失败全额退回。
| 价格 | |
|---|---|
| 每次 | $0.0936 |
费用 = 每次的价格，和文件大小、时长无关
使用步骤
如何使用 AI 扩图 API
- 1
第 1 步: 获取 API Key
用 Google 登录 NanoAPI，在控制台的 API Keys 页面创建一个 Key。每个请求都用它鉴权，请只放在你的服务端。
- 2
第 2 步: 充值余额
在控制台的充值页面充值。余额以美元预付，永不过期，NanoAPI 的所有图片和视频模型共用。
- 3
第 3 步: 创建任务
调用 POST /v1/tasks，传 model outpaint-image、image_url（能直接下载的公开 http(s) 链接）和 aspect_ratio。aspect_ratio 每次都必须传，想让系统自动挑最接近的比例，就传 auto。
- 4
第 4 步: 获取图片
任务结束后推送一次到你的 webhook_url，也可以每隔 15 秒以上轮询 GET /v1/tasks/{task_id}。大约一分钟后，扩好的 PNG 就在 outputs[].url。
为什么选 NanoAPI
为什么在 NanoAPI 上使用 AI 扩图 API
一个 Key 调所有模型
扩完图还想放大或者抠图？同一个 API Key、同一份余额都能调。NanoAPI 的所有模型都走 POST /v1/tasks，返回同一种任务对象。
固定价，失败不收费
每次调用 AI 扩图 API 的价格都一样。图片读不了或者任务失败时，冻结的钱退回余额。
回调或轮询
传一个 webhook_url，任务结束时收到一次推送，按 Standard Webhooks 规范签名（验证签名是可选的）；也可以轮询单个任务，或者一次查询一批任务 ID。
安全重试，消费有上限
带上 Idempotency-Key，重发的请求会返回已经建好的任务，不会重复扣费。还可以在控制台给每个 Key 设每小时、每天或总的消费限额。
每个请求都能在控制台查到
控制台里能看到每个请求的状态、输入、费用和结果，按产品统计的每日用量和每一笔余额变动，还能管理 API Key 和回调签名密钥。
先在线试，再接入
本页工作台用的是同一个模型、同样的价格，写代码之前就能拿自己的图片试效果。文档还提供一份 llms.txt，方便交给 AI 编程助手。
使用场景
用 AI 扩图 API 能做什么
一张图适配所有尺寸
一张商品图或活动主图，扩成 1:1 的信息流图、4:5 的竖图、9:16 的开屏图，以及 16:9、21:9 的横幅，不用重新拍。
给太满的构图留白
人像或商品拍得太紧？扩一下就有了留白，旁边正好放标题、按钮或 Logo。
壁纸和背景图
把插画或风景照扩成宽屏壁纸、PPT 背景或视频封面，比例刚好是你需要的那一种。
在产品里做「一键改尺寸」
在设计工具、广告投放平台或 CMS 里加一个改尺寸功能：用户选好版位，你的服务端调用 AI 扩图 API，扩好的图直接放进去。
01什么是 AI 扩图 API？
一个把图片往外扩、扩成新画面比例的 HTTP 接口。在 NanoAPI 上调用 POST /v1/tasks，传 model outpaint-image、image_url 和 aspect_ratio，再通过回调或轮询拿到一张 PNG。
02扩一次图多少钱？
每次固定价，不论选哪种比例。创建任务时冻结，成功后扣费，失败全额退回。实时价格见上面的表格、价格页和 GET /v1/products。
03可以选哪些比例？
auto、1:1、3:2、2:3、4:3、3:4、4:5、5:4、9:16、16:9、21:9。auto 会从另外 10 种里挑和原图最接近的一种。aspect_ratio 是必传参数，每个请求都要带上。
04只是在原图外面加一圈边吗？
不是。原图会先缩小、放在新画面中间，模型把四周整片画出来。你拿到的是一个明显更大的场景，原图在正中，而不是原图边上补了窄窄的一条。
05结果图有多大？
PNG，尺寸由模型按所选比例决定，例如 16:9 是 2752×1536。每个结果还有一张长边不超过 1024 像素的 JPEG 预览图（preview_url），所有链接都是公开的，不会过期。
06需要写提示词吗？
不需要。outpaint-image 只看你的图片，自己决定四周画什么。请求里传 image_url 和 aspect_ratio 即可；传了这个模型没有的参数（例如 prompt），会返回 400 invalid_request。
07扩图要多久？图片用不了会怎样？
从创建到出结果约 1–1.5 分钟，服务繁忙时会更久。图片在任务运行时读取：下载不了或打不开时，任务以 invalid_media 失败，冻结的费用全额退回。
08可以先在线试用再接入吗？
可以。用 Google 登录后直接用本页顶部的工作台：它和 AI 扩图 API 是同一个模型、同样的价格，用的也是同一份余额，写代码之前就能确认效果和费用。
开始使用 AI 扩图 API
先在上面的工作台扩一张图，再用一次 API 调用，把同样的扩图能力接进你的产品。