跳到内容

白模视频生成 ​

更新时间

白模视频生成把剧本或分镜交给云端,自动完成 3D 建模、运镜与渲染,输出一段 3D 白模预演视频 和对应的 Blender 工程文件。白模用于先确认场景布局、人物动作与镜头运动,确认后再以白模为参考生成上色成片;3D 文件可继续编辑和复用。

适用场景:影视分镜预演、短剧制作、营销视频生产等。

创作流程 ​

步骤做什么产出
① 输入剧本 / 分镜文本,可附参考图或已有 Blender 工程—
② 白模生成云端完成建模、运镜、渲染(单次约 5~10 分钟)白模 MP4 + Blender 工程
③ 多轮修改(可选)在同一会话 / 用 previous_task_id 描述调整内容新一版白模
④ 参考生成成片(可选)以白模为参考,调用视频生成模型出成片成片 MP4

先改白模,再出成片

白模结果不满意时,优先在白模阶段修改场景、动作与运镜并确认效果,再做参考生成 —— 不必在成片阶段反复抽卡。

两种使用方式 ​

方式适用入口
Demo 体验可视化操作、快速体验、少量任务演示网站(地址与 API Key 请联系商务架构师)
接口调用批量任务、接入自有服务POST /v1/videos/generations + POST /v1/videos/generations/query

方式一:Demo 体验 ​

1. 配置接口 ​

打开演示网站,点击右上角「接口设置」:

  • 白模视频生成接口地址:保持默认 https://agent-task-manager.crtrcloud.com。
  • API Key:联系架构师获取后填入。
  • 白模参考生视频(可选):如需以白模生成成片,联系架构师开通 TokenHub 视频生成能力,再展开此项填写生成接口地址、查询接口地址({id} 为任务号占位符,保留即可)与 API Key。只体验白模时可不配。

填写后点击「保存」。

接口设置面板:接口地址保持默认,填写 API Key

2. 发起任务 ​

  1. 写提示词:在右侧输入框描述画面与分镜,交代机位、运镜、每段时间轴与主体动作。
  2. 传参考图(可选):最多 6 张(PNG / JPEG / WebP / GIF),用于角色、场景与风格参考;也可上传之前生成的 Blender 工程作为基础。
  3. 选模型并发送:Flash 适合短视频、短剧等简单场景,主打快速;Pro 适合电影级、复杂场景的精细生成。

演示站首页:左侧画布展示示例,右侧为会话与输入框

提示词写法要点

  • 按时间轴拆分动作(如 0–3s / 3–6s),写清每段的景别、机位(俯视 / 环绕 / 上升)与主体行为。
  • 单次生成最长 30 秒,单个分镜最短 1 秒(演示站口径)。
  • 使用 Blender 工程时,在提示词里写明保留什么、改什么,例如「使用工程中的走廊场景,保留楼梯和人物位置,将镜头改为缓慢环绕」。

3. 查看与下载 ​

任务完成后,左侧画布出现白模视频卡片,可播放预览、下载 MP4、下载 Blender 工程,或继续做白模参考生视频。

白模产物卡:预览、下载 MP4 / Blender 文件、继续参考生视频

产物只在当前页面有效

Demo 没有历史会话:切换新对话或超过 24 小时后产物即过期、无法再次加载,请及时下载 MP4 或 Blender 工程文件。

4. 白模参考生成成片(可选) ​

确认白模效果后,打开「白模参考生视频」面板:检查自动扩写的提示词,补充角色 / 场景参考图地址,设置分辨率、比例与时长,点击「开始生成」。可选值以接入的视频模型为准。

白模参考生视频参数面板:提示词、参考图地址、分辨率、比例与时长

需要再调整白模时,直接在同一会话输入修改要求(如「人物动作可以再流畅点」)即可发起下一轮。

在同一会话中继续修改白模

方式二:接口调用 ​

调用流程总览 ​

步骤接口关键输入关键输出
① 鉴权—Authorization: Bearer <API Key>—
② 创建任务POST /v1/videos/generationsmodel + content[]task_id、request_id
③ 轮询结果POST /v1/videos/generations/querytask_idstatus、video_url、blender_url
④ 多轮修改(可选)POST /v1/videos/generationsprevious_task_id + 新 content[]新的 task_id

两个接口共用 Bearer 鉴权,参数都放在 JSON body,字段为 snake_case。创建接口是异步的:HTTP 成功只代表任务已受理,状态与产物地址一律通过查询接口获取。

1. 配置鉴权 ​

bash
export WAND_API_KEY="YOUR_API_KEY"
export WAND_API_BASE="https://agent-task-manager.crtrcloud.com"

API Key 向架构师获取;不要写进公开网页、代码仓库或日志。

2. 创建任务 ​

bash
curl --silent --show-error --fail-with-body \
  -X POST "${WAND_API_BASE}/v1/videos/generations" \
  -H "Authorization: Bearer ${WAND_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "PRO",
    "content": [
      {"type": "text", "text": "生成一段 4 秒白模预演:一个男人从走廊走入府邸,与女子对视,镜头缓慢推进。"}
    ]
  }'

请求参数

参数类型必选说明
modelString是仅接受 PRO / FLASH(大小写不敏感),不要填网站上的模型展示名
contentArray是至少一项,元素格式见下表
previous_task_idString否多轮修改时填上一轮已成功任务的 task_id

content 元素

参数类型必选条件说明
typeString每项必填仅支持 text / image_url / blender_url;其它值返回 400
textStringtype=text多个 text 片段拼接后整体透传,拼接后最长 4000 字符
urlStringtype=image_url 或 blender_url图片或 Blender 工程地址,最长 2048 字符,与 type 同层级

带参考图与 Blender 工程的请求体(图片、工程按需添加,不要求同时传):

json
{
  "model": "PRO",
  "content": [
    {"type": "text", "text": "基于参考场景生成 4 秒白模预演,人物向前行走,镜头缓慢推进。"},
    {"type": "image_url", "url": "https://cos.example.com/ref.png"},
    {"type": "blender_url", "url": "https://cos.example.com/scene.blend"}
  ]
}

输入格式易错点

  • 图片写作 {"type":"image_url","url":"…"},不要套用其它接口的嵌套 image_url.url 写法。
  • 不支持 video_url 输入;接口也没有独立的 duration / resolution / seed 参数,时长等要求写进提示词。
  • 示例 URL 仅作格式示意,需替换为服务可访问的真实地址。

响应

json
{
  "task_id": "1256342408-WandVideo-871172c43c0ae76a910b347b8ec",
  "request_id": "ec7ba810-608d-4865-bd8c-e800ab4f585c"
}

保存 task_id 用于查询与多轮修改,request_id 用于日志定位。创建响应不含状态与产物地址;ID 原样保存,不要依赖其前缀或格式做校验。

3. 查询任务结果 ​

查询同样是 POST + JSON body,不是 URL 查询参数:

bash
export TASK_ID="TASK_ID_FROM_CREATE_RESPONSE"
curl --silent --show-error --fail-with-body \
  -X POST "${WAND_API_BASE}/v1/videos/generations/query" \
  -H "Authorization: Bearer ${WAND_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{\"task_id\":\"${TASK_ID}\"}"

响应字段

字段类型说明
statusStringprocessing(生成中)/ success(成功)/ failed(失败)
video_urlString白模 MP4 地址;未完成时为空字符串
blender_urlStringBlender 工程地址;未完成时为空字符串
error_messageString失败原因,仅 failed 时非空;成功时可能省略
json
{
  "status": "success",
  "video_url": "https://your-bucket.cos.ap-guangzhou.myqcloud.com/out.mp4",
  "blender_url": "https://your-bucket.cos.ap-guangzhou.myqcloud.com/scene.blend"
}

按状态处理

status处理
processing间隔一段时间再查,不要重复创建同一任务
success读取 video_url / blender_url 下载产物;需要调整就发起下一轮
failed停止轮询,读 error_message;不能基于失败任务继续多轮修改

轮询策略由调用方决定

接口未规定轮询频率与产物链接有效期。下方示例用 10 秒间隔、30 分钟总超时,均为可调整的客户端示例值,不是服务承诺。

完整示例(Python 标准库) ​

创建任务并轮询到结束;创建出错或网络超时时不会自动重复创建,避免产生重复任务。

python
import json, os, time
from urllib import request, error

BASE_URL = "https://agent-task-manager.crtrcloud.com"
API_KEY = os.environ["WAND_API_KEY"]
POLL_INTERVAL = 10        # 客户端示例值
WAIT_TIMEOUT = 30 * 60    # 客户端示例值


def post_json(path, body, timeout=60):
    req = request.Request(
        BASE_URL + path,
        data=json.dumps(body, ensure_ascii=False).encode("utf-8"),
        headers={"Authorization": "Bearer " + API_KEY,
                 "Content-Type": "application/json"},
        method="POST",
    )
    try:
        with request.urlopen(req, timeout=timeout) as resp:
            return json.load(resp)
    except error.HTTPError as exc:
        raise RuntimeError(f"HTTP {exc.code},勿自动重复创建任务") from exc


created = post_json("/v1/videos/generations", {
    "model": "PRO",
    "content": [{"type": "text",
                 "text": "生成 4 秒白模预演:人物从走廊走入府邸,镜头缓慢推进。"}],
})
task_id = created["task_id"]
print("task_id:", task_id)

deadline = time.monotonic() + WAIT_TIMEOUT
while time.monotonic() < deadline:
    result = post_json("/v1/videos/generations/query", {"task_id": task_id})
    status = result.get("status")
    if status == "success":
        print("video_url:", result["video_url"])
        print("blender_url:", result["blender_url"])
        break
    if status == "failed":
        raise RuntimeError(result.get("error_message") or "任务生成失败")
    time.sleep(POLL_INTERVAL)
else:
    raise TimeoutError(f"客户端停止等待,任务可能仍在运行:{task_id}")

4. 多轮修改 ​

先确认上一轮 status=success,再调用创建接口,用 previous_task_id 指向上一轮,在 content 里写清要调整的内容。新请求返回新的 task_id,之后查询新 ID。

bash
export PREVIOUS_TASK_ID="SUCCESSFUL_TASK_ID"
curl --silent --show-error --fail-with-body \
  -X POST "${WAND_API_BASE}/v1/videos/generations" \
  -H "Authorization: Bearer ${WAND_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"PRO\",
    \"previous_task_id\": \"${PREVIOUS_TASK_ID}\",
    \"content\": [
      {\"type\": \"text\", \"text\": \"保留场景与人物,将镜头改为从侧面缓慢环绕,人物行走速度放慢。\"}
    ]
  }"

多轮修改不是覆盖原任务

上一轮仍在 processing 或已 failed 时发起修改会返回 HTTP 409。要继续调整,使用最近一个成功任务的 task_id。

HTTP 错误码 ​

创建与查询两个接口通用。HTTP 错误与查询结果中的 status=failed 是两层结果,需分别处理。

HTTP含义处理建议
400参数错误:必填缺失、type 不支持、长度超限、model 不支持等检查 PRO / FLASH、content 格式、4000 字符文本与 2048 字符 URL 上限
401Bearer Key 未命中或已过期核对请求头与密钥有效性;不要在日志中打印密钥
404查询的任务不存在核对 task_id 是否来自创建响应
409前一个任务尚未成功,不允许多轮修改先查询前任务状态,success 后再修改
500能力未装配或服务端内部故障保留 request_id / task_id 与状态码联系接口提供方,不要盲目重复创建
  • 超时 ≠ 任务取消:客户端超时不代表服务端任务已取消,已有 task_id 就继续查询;创建响应丢失时先核查再决定是否重试。
  • 能力边界:接口未定义取消、幂等键、限流、CORS 与回调配置;演示站的 30 秒时长、6 张图片上限不等同于 API 约束。

计费说明 ​

目前 Demo 体验与 API 接入测试暂时免费,预计 11 月中开始计费。计费由「多模态理解和执行」+「实时云渲染」两部分构成,合并折算为 Tokens 出账(10 元 / 百万 Tokens,或 1.6 美元 / 百万 Tokens)。白模参考生成成片的费用按实际开通的视频模型另计。

档位多模态理解和执行(元 / 百万 Tokens)实时云渲染
Pro输入 67 · 输出 335 · 缓存命中 6.7约 0.2 元 / 分钟
Flash输入 16 · 输出 80 · 缓存命中 1.6约 0.2 元 / 分钟
Lite输入 2 · 输出 7 · 缓存命中 0.57约 0.2 元 / 分钟

例:使用 Pro 档,多模态理解与执行消耗 50 元 + 云渲染 2 元,合计 52 元,按 520 万 Tokens 出账。价格以正式计费公告为准。

使用注意 ​

  • 单任务运行:Demo 一次只能跑一个任务,等当前任务完成再发起;Demo 与 API 可同时运行不同任务。
  • 耗时:页面上的「预估生成时间」为演示口径,实际以服务端为准。
  • 密钥安全:Bearer Key 只放在服务端或本地环境变量,不要写进公开 HTML。
  • 产物保存:Demo 产物 24 小时内有效且不留历史会话;API 产物请以查询返回的地址及时下载。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages