AI 视频改画幅 API ： 改视频比例，不裁掉画面
传一段视频，选一个新比例，原来画面之外的区域由 AI 补画出来，横屏视频就能变成完整的竖屏视频。先在这里在线试，满意后用一个 API Key、一份余额，把同一个模型接进你的产品。
- 一段视频，4–60 秒
- 6 种比例，分辨率跟随原视频
- 按源视频计价
- 同一个模型，API 直接调
功能亮点
AI 视频改画幅 API 的核心能力
6 种目标比例
可以改成 16:9、9:16、4:3、3:4、1:1 或 21:9：竖屏给短视频和快拍，方形给信息流，宽屏给播放器和电影感的剪辑。
补画新区域，而不是裁剪
不是把画面裁成新比例，而是由模型把多出来的空间画出来，原来的画面留在镜头里，不会被裁掉。
用参考图引导补画
15 秒以内的视频，可以在 image_urls 里加最多 2 张参考图，告诉模型新区域该画什么，例如布景、背景墙或商品陈列。
保持源视频分辨率
结果是 mp4，分辨率跟随源视频：480p、720p 或 1080p。短边超过 1080 像素的视频，会先缩到 1080。
源视频 4–60 秒
源视频要在 4 到 60 秒之间。超出范围或者读不了的视频，几秒内就会失败，不扣费。
按源视频计价
按源视频的秒数计价，每秒单价由源视频的分辨率决定，另加每次的固定费用。价格在创建后几秒内按你的视频算出，在开始处理之前冻结。
简介
什么是 AI 视频改画幅 API？
- 模型 ID
reframe-video- 素材
- 一段视频
- 分辨率
- 跟随原视频
- 画面比例
- 6 种
- 视频时长
- 4–60 秒
- 参考图
- 最多 2 张（15 秒以内的视频）
- 价格
- 每秒 $0.1404 起，另加每次 $0.1404
改画幅就是改视频的画面比例。常见的做法是裁剪，边缘和一部分动作会被直接裁掉。AI 改画幅正好反过来：保留原来的画面，把新增空间里应该出现的内容画出来。这样一段 16:9 的视频改成 9:16 后，是一个真正的竖屏视频，而不是从原画面里切下来的窄窄一条。
AI 视频改画幅 API 把这件事做成了一个 HTTP 接口。在 NanoAPI 上，它是产品 reframe_video 下的模型 reframe-video：传 video_url 和 aspect_ratio，可以再带最多 2 张参考图（image_urls），拿回一个和源视频分辨率相同的 mp4。新区域需要出现特定内容时，参考图很有用，但只有 15 秒以内的视频能带。
价格跟着源视频走：每秒单价由源视频的分辨率（480p、720p 或 1080p）决定，另加每次的固定费用。任务创建后几秒内，NanoAPI 会读取视频、算出金额并冻结，成功后的扣费不会更高；任务失败全额退回。
改画幅需要一些时间：一段 10 秒的视频约 7 分钟，建议用回调接收结果。你可以先在本页顶部的工作台在线试，再在自己的应用里通过 https://api.nanoapi.ai/v1 调用 AI 视频改画幅 API，用的是和 NanoAPI 其他模型同一个 API Key、同一份预付余额。
价格
AI 视频改画幅 API 价格
每次的固定费用，加上按源视频秒数计算的费用，每秒单价由源视频的分辨率决定。金额在创建任务后几秒内冻结，任务失败全额退回。
| 源视频 | 每秒 | 每次另加 | 10 秒视频 |
|---|---|---|---|
| 480p | $0.1404 | $0.1404 | $1.5444 |
| 720p | $0.2106 | $0.1404 | $2.2464 |
| 1080p | $0.5616 | $0.1404 | $5.7564 |
费用 = 每次另加的费用 + 每秒单价 × 源视频秒数（四舍五入到整秒）
工作台上显示的是预估价，创建后几秒内读完源视频，冻结准确的金额
使用步骤
如何使用 AI 视频改画幅 API
- 1
第 1 步: 获取 API Key
用 Google 登录 NanoAPI，在控制台的 API Keys 页面创建一个 Key。每个请求都用它鉴权，请只放在你的服务端。
- 2
第 2 步: 充值余额
在控制台的充值页面充值。余额以美元预付，永不过期，NanoAPI 的所有图片和视频模型共用。
- 3
第 3 步: 创建任务
调用 POST /v1/tasks，传 model reframe-video、video_url（4–60 秒视频的公开 http(s) 链接）和必传的 aspect_ratio。视频在 15 秒以内时，可以再用 image_urls 带最多 2 张参考图。
- 4
第 4 步: 获取视频
任务结束后推送一次到你的 webhook_url，也可以每隔 15 秒以上轮询 GET /v1/tasks/{task_id}。按分钟来预估时间：10 秒的视频约 7 分钟。结果在 outputs[].url。
为什么选 NanoAPI
为什么在 NanoAPI 上使用 AI 视频改画幅 API
一个 Key 调所有模型
用 Kling 4.0 或 Seedance 2.5 生成视频，改成各个平台需要的比例，再放大，全程用同一个 API Key、同一份余额，都走 POST /v1/tasks。
素材不合格，不扣钱
视频读不了、不在 4–60 秒之间，或者超过 15 秒还带了参考图，任务几秒内就失败，不扣费；后面的环节失败也全额退回。
回调或轮询
传一个 webhook_url，任务结束时收到一次推送，按 Standard Webhooks 规范签名（验证签名是可选的）；也可以轮询单个任务，或者一次查询一批任务 ID。
安全重试，消费有上限
带上 Idempotency-Key，重发的请求会返回已经建好的任务，不会重复扣费。还可以在控制台给每个 Key 设每小时、每天或总的消费限额。
每个请求都能在控制台查到
控制台里能看到每个请求的状态、输入、费用和结果，按产品统计的每日用量和每一笔余额变动，还能管理 API Key 和回调签名密钥。
先在线试，再接入
本页工作台用的是同一个模型、同样的价格，写代码之前就能拿自己的视频试效果。文档还提供一份 llms.txt，方便交给 AI 编程助手。
使用场景
用 AI 视频改画幅 API 能做什么
横屏转竖屏
把 16:9 的素材改成 9:16，用在短视频和快拍里，站在画面边上的人也不会被裁掉。
信息流用的方形和 3:4
同一段视频改成 1:1 或 3:4，在社交信息流和商品详情页里占满更多屏幕。
电影感宽屏
把视频扩成 21:9，用于预告片、官网首屏视频和宽屏显示设备。
一条广告，适配所有版位
一条商品视频按每个投放版位的比例各出一版，用商品或布景的参考图引导新区域的内容。你的服务端按比例各调用一次 AI 视频改画幅 API 即可。
01什么是 AI 视频改画幅 API？
一个改变视频画面比例的 HTTP 接口：新增的区域由 AI 补画，而不是裁剪。在 NanoAPI 上调用 POST /v1/tasks，传 model reframe-video、video_url 和 aspect_ratio，可以再带参考图，然后通过回调或轮询拿到一个 mp4。
02视频改画幅怎么收费？
每次的固定费用，加上按源视频秒数（四舍五入到整秒）计算的费用，每秒单价按源视频的分辨率区分：480p、720p、1080p，更高的按 1080p 算。金额在创建后几秒内冻结，最终扣费不会更高。实时价格见上面的表格、价格页和 GET /v1/products。
03支持哪些比例？
16:9、9:16、4:3、3:4、1:1 和 21:9。aspect_ratio 每个任务都必须传，按你要发布的平台选比例即可。
04参考图有什么用？
参考图用来引导新区域画什么，例如背景、房间或商品陈列。image_urls 里最多放 2 张，但只有源视频在 15 秒以内时才能带；更长的视频带了参考图，任务会以 invalid_request 失败，不扣费。
05视频最长多长？输出是什么分辨率？
源视频要在 4 到 60 秒之间。输出是 mp4，分辨率跟随源视频：480p、720p 或 1080p；短边超过 1080 像素的视频会先缩到 1080。
06改画幅要多久？
通常 5–10 分钟，一段 10 秒的视频约 7 分钟。建议传一个 webhook_url，视频做好时你的应用会收到通知，不用一直轮询。
07视频用不了会怎样？
任务创建后几秒内，NanoAPI 会读取源视频。下载不了或读不出来，任务以 invalid_media 失败；短于 4 秒或长于 60 秒，以 video_too_short 或 video_too_long 失败。这几种情况都不扣费。
08可以先在线试用再接入吗？
可以。用 Google 登录后直接用本页顶部的工作台：它和 AI 视频改画幅 API 是同一个模型、同样的价格，用的也是同一份余额，写代码之前就能确认效果和费用。
开始使用 AI 视频改画幅 API
先在上面的工作台改一段视频的画幅，再用一次 API 调用，把同样的能力接进你的产品。