# RelayDance

> Seedance 视频生成 API：兼容 OpenAI，异步处理，支持 webhook 回调，多参考图融合。Base URL `https://relaydance.com/v1`。

RelayDance（relaydance.com）是一个以视频为核心的 AI 生成 API。它通过一个兼容 OpenAI 的端点提供字节跳动 Seedance 2.0（480p、720p、1080p 和原生 4K，另有 Fast 与 Mini）、Seedance 1.5 Pro 和 HappyHorse 视频模型、gpt-image-2 图像生成以及 Seedance 超分辨率。无需排队，无需 BytePlus 账户或 KYC，支持人脸与人像生成，还提供官方平台没有的特殊 SKU。

## API 快速参考

Base URL：`https://relaydance.com/v1`

- `POST /v1/video/generations` 提交视频任务。请求体：`model`、`prompt`、`seconds`，以及用于厂商参数的 `metadata`（`ratio`、`resolution`、`generate_audio`、`callback_url`、`content[]` 参考媒体）。
- `GET /v1/video/generations/{task_id}` 轮询任务，直到 `status` 为 `succeeded` 或 `failed`；结果中包含视频 `url`。
- Webhook 模式：提交时设置 `metadata.callback_url`，最终任务状态会被 POST 到你的服务器，并带有重试机制。无需轮询。
- 参考媒体以 `{ "type": "image_url", "image_url": { "url": "..." }, "role": "reference_image" }` 的形式放入 `metadata.content[]`，并在 prompt 中以 `@image1` 到 `@imageN` 引用。每个请求最多 9 张参考图、3 段参考视频和 3 条音轨。
- `POST /v1/images/generations` 使用 `gpt-image-2` 生成图像（兼容 OpenAI）；图像输出免费，仅按输入收费。
- `POST /v1/files` 上传媒体文件。
- `GET /v1/models` 列出你的密钥可用的模型。

认证方式：`Authorization: Bearer YOUR_API_KEY`（在控制台创建密钥：https://relaydance.com/console）
支付方式：USDT and Stripe (credit / debit card)
价格：按生成视频量付费，无需排队、无需 KYC，失败请求永不计费。各模型实时费率：https://relaydance.com/models
失败或出错的请求永不计费。

## 视频模型

- `doubao-seedance-2-0-1080p`
- `doubao-seedance-2-0-480p`
- `doubao-seedance-2-0-4k`
- `doubao-seedance-2-0-720p`
- `doubao-seedance-2-0-fast-260128`
- `doubao-seedance-2-0-mini-480p`
- `doubao-seedance-2-0-mini-720p`
- `seedance-upscale-1080p`
- `seedance-upscale-2k`
- `seedance-upscale-4k`
- `seedance-upscale-720p`
- `happyhorse-1.0-i2v`
- `happyhorse-1.0-r2v`
- `happyhorse-1.0-t2v`
- `happyhorse-1.0-video-edit`

## 图像模型

- `gpt-image-2`

## 链接

- 控制台与 API 密钥：https://relaydance.com/console
- 实时模型列表与价格：https://relaydance.com/models
- 文档：https://relaydance.com/docs
- 视频 API 参考：https://relaydance.com/docs/video