如何使用 black-forest-labs/flux-3/video-extend 视频续写 API:视频转视频接入指南(2026)
black-forest-labs/flux-3/video-extend 视频续写 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。
black-forest-labs/flux-3/video-extend 视频续写 是一款视频转视频模型(由 Black Forest Labs 提供):FLUX 3 Video Extend 可将输入视频延续生成新的 5–20 秒片段,并通过提示词控制后续动作、镜头运动、视觉风格、运动连贯性,以及可选的同步音频,支持 720P / 1080P 输出。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $2.05。
TL;DR
· 任务类型:视频转视频,由 Black Forest Labs 提供
· 价格:典型一次调用约 $2.05($1 = 100 积分),按量计费无订阅
· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入
· 可调参数:5 个(见下方参数表)
· 无平台水印,商用可用(遵守服务条款)
用 black-forest-labs/flux-3/video-extend 视频续写 能做什么?
短视频与广告片段:从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览:低成本验证分镜和视觉方向,再决定是否实拍。
社媒内容工厂:批量生成竖屏短片,配合热点话题快速上线。
已有素材的二次创作:图生视频让静态作品动起来,延长内容生命周期。
怎么调用这个 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-extend" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Continue the scene naturally, preserving the subjects, setting, lighting and motion of the input video.",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}
}'
# 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(提示词):必填
aspect_ratio(宽高比):可选
resolution(分辨率):可选,默认 "720p"
duration(时长):可选,默认 5
generate_audio(生成音频):可选,默认 true
black-forest-labs/flux-3/video-extend 视频续写 的提示词怎么写?
- 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
- 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
- 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
- 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。
价格是多少?
按次积分计价,典型一次调用约 $2.05($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。
black-forest-labs/flux-3/video-extend 视频续写
black-forest-labs/flux-3/video-extend
FLUX 3 Video Extend 可将输入视频延续生成新的 5–20 秒片段,并通过提示词控制后续动作、镜头运动、视觉风格、运动连贯性,以及可选的同步音频,支持 720P / 1080P 输出。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
参数
| 参数 | 类型 | 必填 | 默认值 | 范围/说明 |
|---|---|---|---|---|
prompt | string | 是 | — | max 5000 chars; 描述你想生成的视频内容的文本提示词。 |
video | string | 是 | — | 输入视频的 URL。需为 MP4 格式,大小不超过 50 MB,时长不超过 15 秒。 |
aspect_ratio | string | 否 | — | 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16; 生成内容的宽高比。 |
resolution | string | 否 | "720p" | 720p, 1080p; 生成视频的分辨率。 |
duration | integer | 否 | 5 | 5–20; step 1; 视频时长(秒),范围为 5–20。 |
generate_audio | boolean | 否 | true | 是否为视频生成音频。 |
价格
| Mode | USD / second | Credits / second | USD / 5 seconds |
|---|---|---|---|
| 720p | $0.41 | 41 | $2.05 |
| 1080p | $0.53 | 53 | $2.65 |
费用=单价 × min(ceil(duration), 20)。duration 为 5~20 的整数秒,默认 5 秒。generate_audio 不改变价格。 按请求的续写时长计费,不按输入视频时长计费。
与 WaveSpeed 官方标准标价一致;1 美元 = 100 积分。账户折扣另行计算。
API
curl -X POST https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/video-extend \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"prompt": "Continue the scene naturally, preserving the subjects, setting, lighting and motion of the input video.",
"video": "https://assets-public.namifusion.com/marketplace/videos/2026-04-14/88d6efad3763.mp4",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}
}'
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-extend 视频续写 的任务要跑多久?+
取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。
分辨率/时长上限是多少?+
以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。