RelayDanceDocs / 核心概念 / 工作原理
RelayDance 工作原理
RelayDance 是位于你的应用与上游模型供应商之间的网关。你只需对接一个 API 和一个密钥；网关会把每个请求转发给提供你所请求模型的供应商。
#请求流程
- 鉴权：校验你的 API 密钥并检查余额。
- 路由：根据
model字段把请求转发给上游供应商。 - 响应：供应商的输出以统一的格式返回给你。
#同步与异步
同步（图像）
图像生成会直接在 HTTP 响应中返回结果，无需轮询。RelayDance 只提供视频与图像生成，不含对话或 LLM 模型。
异步（视频）
视频渲染需要数分钟，因此 API 不会一直保持连接打开。POST /v1/video/generations 会立即返回一个 task_id；你可以轮询 GET /v1/video/generations/{task_id}，或者设置 metadata.callback_url，以 webhook 的方式接收最终的任务状态。
| 状态 | 含义 |
|---|---|
submitted | 任务已接受并进入队列 |
running | 正在生成中 |
succeeded | 已完成：url 字段中包含视频 |
failed | 生成失败，不计费 |
#上游供应商
来自领先 AI 实验室的视频与图像模型:
| 供应商 |
|---|
ByteDance (Seedance) |
HappyHorse |
OpenAI (gpt-image-2) |
#计费
用量按请求计量：
- 图像生成：按请求计费；图像输出免费，你只为输入付费
- 视频生成：按每段视频计费；价格随模型、分辨率与时长而变化
失败的请求不计费：你只为成功交付的输出付费。
按生成视频量付费，无需排队、无需 KYC，失败请求永不计费。查看每个模型的具体价格，请见价格页面。