Docs / 模型 API / 超分辨率

超分辨率

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

#状态: 已上线内容

720p 和原生 4K 放大现已上线，通过 seedance-upscale-720p 和 seedance-upscale-4k 调用。1080p 和 2K 已在目录中，但即将推出: 其背后按分辨率的工作流尚未构建完成。

#如何调用

超分辨率使用与视频生成相同的异步任务 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 或 seedance-upscale-4k，并把源视频放入 metadata.content[]。不需要 prompt。响应中会带有一个 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"
}

4K 示例

请求形状完全相同，只是 model 不同：设为 seedance-upscale-4k 即可得到原生 4K 输出。

curl https://relaydance.com/v1/video/generations \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-upscale-4k",
    "metadata": {
      "content": [
        {
          "type": "video_url",
          "video_url": { "url": "https://example.com/my-720p-clip.mp4" },
          "role": "reference_video"
        }
      ]
    }
  }'
# -> { "task_id": "task_xyz789", "status": "queued" }

curl https://relaydance.com/v1/video/generations/task_xyz789 \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY"

{
  "task_id": "task_xyz789",
  "status": "completed",
  "url": "https://...4k.mp4",
  "format": "mp4"
}

请求参数

#控制台自动超分

RelayDance 控制台的视频生成页面上有一个“生成后自动超分到 4K”勾选框。它并不是一个特殊的 API 参数，POST /v1/video/generations 上并没有 auto_upscale 这样的 flag。勾选它会自动执行两次独立调用: 生成任务成功后，控制台会提交第二个任务，model 为 "seedance-upscale-4k"，源片段就是刚生成完的视频 URL，无需二次确认。如果你是直接调用 API，做法完全一样: 先正常生成，再把结果 URL 作为后续调用提交给 seedance-upscale-4k。

#计费

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

#常见问题

它能放大任意视频吗？

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

这与原生 4K 有何不同？

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

为什么 1080p 和 2K 还没上线？

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