白模视频生成
白模视频生成把剧本或分镜交给云端,自动完成 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。只体验白模时可不配。
填写后点击「保存」。

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

提示词写法要点
- 按时间轴拆分动作(如
0–3s/3–6s),写清每段的景别、机位(俯视 / 环绕 / 上升)与主体行为。 - 单次生成最长 30 秒,单个分镜最短 1 秒(演示站口径)。
- 使用 Blender 工程时,在提示词里写明保留什么、改什么,例如「使用工程中的走廊场景,保留楼梯和人物位置,将镜头改为缓慢环绕」。
3. 查看与下载
任务完成后,左侧画布出现白模视频卡片,可播放预览、下载 MP4、下载 Blender 工程,或继续做白模参考生视频。

产物只在当前页面有效
Demo 没有历史会话:切换新对话或超过 24 小时后产物即过期、无法再次加载,请及时下载 MP4 或 Blender 工程文件。
4. 白模参考生成成片(可选)
确认白模效果后,打开「白模参考生视频」面板:检查自动扩写的提示词,补充角色 / 场景参考图地址,设置分辨率、比例与时长,点击「开始生成」。可选值以接入的视频模型为准。

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

方式二:接口调用
调用流程总览
| 步骤 | 接口 | 关键输入 | 关键输出 |
|---|---|---|---|
| ① 鉴权 | — | Authorization: Bearer <API Key> | — |
| ② 创建任务 | POST /v1/videos/generations | model + content[] | task_id、request_id |
| ③ 轮询结果 | POST /v1/videos/generations/query | task_id | status、video_url、blender_url |
| ④ 多轮修改(可选) | POST /v1/videos/generations | previous_task_id + 新 content[] | 新的 task_id |
两个接口共用 Bearer 鉴权,参数都放在 JSON body,字段为 snake_case。创建接口是异步的:HTTP 成功只代表任务已受理,状态与产物地址一律通过查询接口获取。
1. 配置鉴权
export WAND_API_KEY="YOUR_API_KEY"
export WAND_API_BASE="https://agent-task-manager.crtrcloud.com"API Key 向架构师获取;不要写进公开网页、代码仓库或日志。
2. 创建任务
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 秒白模预演:一个男人从走廊走入府邸,与女子对视,镜头缓慢推进。"}
]
}'请求参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | String | 是 | 仅接受 PRO / FLASH(大小写不敏感),不要填网站上的模型展示名 |
content | Array | 是 | 至少一项,元素格式见下表 |
previous_task_id | String | 否 | 多轮修改时填上一轮已成功任务的 task_id |
content 元素
| 参数 | 类型 | 必选条件 | 说明 |
|---|---|---|---|
type | String | 每项必填 | 仅支持 text / image_url / blender_url;其它值返回 400 |
text | String | type=text | 多个 text 片段拼接后整体透传,拼接后最长 4000 字符 |
url | String | type=image_url 或 blender_url | 图片或 Blender 工程地址,最长 2048 字符,与 type 同层级 |
带参考图与 Blender 工程的请求体(图片、工程按需添加,不要求同时传):
{
"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 仅作格式示意,需替换为服务可访问的真实地址。
响应
{
"task_id": "1256342408-WandVideo-871172c43c0ae76a910b347b8ec",
"request_id": "ec7ba810-608d-4865-bd8c-e800ab4f585c"
}保存 task_id 用于查询与多轮修改,request_id 用于日志定位。创建响应不含状态与产物地址;ID 原样保存,不要依赖其前缀或格式做校验。
3. 查询任务结果
查询同样是 POST + JSON body,不是 URL 查询参数:
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}\"}"响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
status | String | processing(生成中)/ success(成功)/ failed(失败) |
video_url | String | 白模 MP4 地址;未完成时为空字符串 |
blender_url | String | Blender 工程地址;未完成时为空字符串 |
error_message | String | 失败原因,仅 failed 时非空;成功时可能省略 |
{
"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 标准库)
创建任务并轮询到结束;创建出错或网络超时时不会自动重复创建,避免产生重复任务。
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。
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 上限 |
| 401 | Bearer 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 产物请以查询返回的地址及时下载。