Docs / 模型 API / 超分辨率

超分辨率

超分辨率使用 AI 模型将已有的低分辨率片段放大到更高的输出档位，因此你可以先以低分辨率快速渲染，再锐化结果。当你追求速度时，它是从头以高分辨率生成的实用替代方案。

#状态: 已上线内容

目前仅 480p 到 720p 的放大已上线，通过模型 seedance-upscale-720p 调用。更高档位已在目录中，但即将推出: 其背后按分辨率的工作流尚未构建完成。

#如何调用

超分辨率使用与视频生成相同的异步任务 API。调用 POST /v1/video/generations，把源片段作为一条 video_url 条目放入 metadata.content[]。该调用会立即返回一个 task_id; 轮询 GET /v1/video/generations/{task_id} 直到任务完成。

1. 提交: 调用 POST /v1/video/generations，将 model 设为 seedance-upscale-720p，并把源视频放入 metadata.content[]。响应中会带有一个 task_id。
2. 轮询: GET /v1/video/generations/{task_id} 会依次经过 queued、in_progress，再到 completed（放大后的片段在 url 字段中）或 failed。

#cURL 示例

# 1) 提交一个放大任务（480p 源 -> 720p 输出）
curl https://relaydance.com/v1/video/generations \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-upscale-720p",
    "metadata": {
      "content": [
        {
          "type": "video_url",
          "video_url": { "url": "https://example.com/my-480p-clip.mp4" }
        }
      ]
    }
  }'
# -> { "task_id": "task_abc123", "status": "queued" }

# 2) 轮询直到放大后的片段就绪
curl https://relaydance.com/v1/video/generations/task_abc123 \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY"

{
  "task_id": "task_abc123",
  "status": "completed",
  "url": "https://...720p.mp4",
  "format": "mp4"
}

请求参数

#计费

超分辨率按用量计费，依据输出时长和分辨率档位收费。模型页面会展示当前的准确费率。失败的请求从不计费: 如果任务以 failed 结束，则不会向你收费。

#常见问题

它能放大任意视频吗？

超分辨率是为你在 RelayDance 上生成的片段而设计的。把片段 URL 作为一条 video_url 条目传入 metadata.content[]。目前已上线的路径是通过 seedance-upscale-720p 将 480p 源放大为 720p 输出。

这与原生 4K 有何不同？

原生 4K（Seedance 2.0 设置 resolution: "4k"）会直接根据你的提示词以 4K 生成片段。超分辨率则是拿一个已完成的低分辨率片段去放大。这是两条不同的路径: 追求最佳画质就原生生成，或者先低分辨率生成再放大，用部分保真度换取速度和更低档位的成本。

为什么目前只支持 720p？

480p 到 720p 的工作流是已经端到端构建并验证过的。1080p、2K 和 4K 放大模型已在目录中，但其按分辨率的工作流尚未就绪，因此标记为即将推出，目前不接受请求。