如何使用 black-forest-labs/flux-3/video-upscale 视频放大 API：视频转视频接入指南（2026）
black-forest-labs/flux-3/video-upscale 视频放大 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
black-forest-labs/flux-3/video-upscale 视频放大 是一款视频转视频模型（由 Black Forest Labs 提供）：默认 creativity=1，$0.79/秒起；creativity=0 为 $0.55/秒。按输入视频时长向上取整计费。FLUX Video Upscale 可对 MP4 视频进行放大增强，支持忠于原始内容或更具创意的细节重建，提供 1.5x 到 3x 可调缩放，并提升画面清晰度，适用于视频修复、社交内容、广告和制作流程。即开即用的 REST 推理 API，性能出色，无冷启动，价格实惠。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.790。
TL;DR
· 任务类型：视频转视频，由 Black Forest Labs 提供
· 价格：典型一次调用约 $0.790（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：3 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 black-forest-labs/flux-3/video-upscale 视频放大 能做什么？
短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。
社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。
已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。
怎么调用这个 API？
- 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
- 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
- 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/video-upscale" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"upscale_factor": 2,
"creativity": 1
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数？
prompt（提示词）：可选
upscale_factor（放大倍数）：可选，默认 2
creativity（创意度）：可选，默认 1
black-forest-labs/flux-3/video-upscale 视频放大 的提示词怎么写？
- 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
- 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
- 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
- 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。
价格是多少？
按次积分计价，典型一次调用约 $0.790（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
black-forest-labs/flux-3/video-upscale 视频放大
black-forest-labs/flux-3/video-upscale
默认 creativity=1，$0.79/秒起；creativity=0 为 $0.55/秒。按输入视频时长向上取整计费。FLUX Video Upscale 可对 MP4 视频进行放大增强，支持忠于原始内容或更具创意的细节重建，提供 1.5x 到 3x 可调缩放，并提升画面清晰度，适用于视频修复、社交内容、广告和制作流程。即开即用的 REST 推理 API，性能出色，无冷启动，价格实惠。
参数
| 参数 | 类型 | 必填 | 默认值 | 范围／说明 |
|---|---|---|---|---|
video | string | 是 | — | 要放大的 MP4 视频。最长时长：20 秒。最大文件大小：50 MB。 |
prompt | string | 否 | — | max 5000 chars; 可选描述，用于引导创意细节增强。留空则进行中性放大。 |
upscale_factor | number | 否 | 2 | 1.5–3; step 0.1; 输出缩放倍数。将保留原始宽高比。 |
creativity | integer | 否 | 1 | 0–1; step 1; 设为 0 表示忠于原始内容的放大，设为 1 表示进行创意细节增强。 |
价格
creativity=0：$0.55/秒（55 积分）；creativity=1（默认）：$0.79/秒（79 积分）。计费秒数=max(1, ceil(min(输入视频实际时长, 20)))。服务端探测视频时长，prompt 和 upscale_factor 不改变单价。例如 5.2 秒收费 $3.30 或 $4.74。
与 WaveSpeed 官方标准标价一致；1 美元 = 100 积分。账户折扣另行计算。
API
curl -X POST https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/video-upscale \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"video": "https://assets-public.namifusion.com/marketplace/videos/2026-04-14/88d6efad3763.mp4",
"upscale_factor": 2,
"creativity": 1
}
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
-H "Authorization: Bearer $API_KEY"
提交后返回 task_uuid；轮询至 completed 或 failed。成功输出字段：output.videos（URL 数组）。本 API 使用异步任务并返回 URL。
常见问题
可以先免费试用吗？+
注册赠送积分仅可用于指定模型，适用范围会持续更新；Playground 提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许，详见服务条款。
black-forest-labs/flux-3/video-upscale 视频放大 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。