如何使用 black-forest-labs/flux-3/text-to-video 文生视频 API：文生视频接入指南（2026）

black-forest-labs/flux-3/text-to-video 文生视频 是一款文生视频模型（由 Black Forest Labs 提供）：FLUX 3 Text-to-Video 可根据文本提示词生成 5-20 秒电影感视频，具备连贯运动、电影级构图、可选同步音频，以及 720P / 1080P 输出，适用于创意视频、社交内容、广告和制作流程。提供开箱即用的 REST 推理 API，性能出色，无冷启动，价格实惠。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.850。

TL;DR

· 任务类型：文生视频，由 Black Forest Labs 提供

· 价格：典型一次调用约 $0.850（$1 = 100 积分），按量计费无订阅

· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入

· 可调参数：5 个（见下方参数表）

· 无平台水印，商用可用（遵守服务条款）

用 black-forest-labs/flux-3/text-to-video 文生视频 能做什么？

短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。

产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。

社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。

已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。

怎么调用这个 API？

1. 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
2. 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/black-forest-labs/flux-3/text-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic tracking shot of a neon-lit street market in Tokyo at night during light rain, reflections shimmering on the pavement, pedestrians with transparent umbrellas moving naturally through the scene, steam rising from food stalls, subtle camera dolly forward, realistic motion, atmospheric lighting, high detail, immersive urban ambience",
    "aspect_ratio": "9:16",
    "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（宽高比）：可选，默认 "9:16"

resolution（分辨率）：可选，默认 "720p"

duration（时长）：可选，默认 5

generate_audio（生成音频）：可选，默认 true

black-forest-labs/flux-3/text-to-video 文生视频 的提示词怎么写？

1. 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
2. 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
4. 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

按次积分计价，典型一次调用约 $0.850（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。