# KOKO 3D 预演台

> 最后更新：2026-09-17。

3D 预演台是独立于无限画布的镜头预演工作流。它不会创建画布节点，也不会修改画布中的图片或视频节点。

## 页面

登录正式站后打开 `/blockout/`，或从控制台左侧进入“3D 预演台”。

## 工作流

1. 添加镜头，填写镜头时长、镜头说明和动作画面。
2. 为每个镜头上传关键帧图片；页面先把本地图片上传到当前站点的临时素材中转。
3. 选择 Seedance 2.0 或 Seedance 2.5，填写整体提示词、比例和清晰度。
4. 点击“整理并生成”；服务端按镜头顺序整理提示词、去重关键帧，再走现有视频生成和扣费链路。

## 参考图限制

- Seedance 2.0：最多 9 张关键帧。
- Seedance 2.5：最多 30 张关键帧。
- 只上传图片关键帧，不把预演视频或音频伪装成图片发送给上游。

## 整理接口

登录态接口：`POST /api/blockout/prepare`

```json
{
  "model": "seedance-2.0",
  "title": "产品片 3D 预演",
  "prompt": "保持主体、空间关系和光线连续",
  "shots": [
    {
      "duration": 5,
      "camera": "中景，缓慢推进",
      "prompt": "主体从画面左侧进入",
      "keyframes": [
        {"url": "https://example.com/frame-01.png"}
      ]
    }
  ]
}
```

接口只返回规范化镜头表、组合提示词和关键帧 URL，不直接扣费。正式生成继续使用登录态的视频生成链路，因此扣费、幂等、任务查询和失败退款规则与视频工作台一致。