RelayDance文档 / API 参考
API 参考
所有 RelayDance 端点共用相同的基础 URL 和鉴权方式。点击任一端点查看完整的参数文档和示例。
#基础 URL
https://relaydance.com/v1
#鉴权
在每个请求中以 bearer token 的形式传入你的 API 密钥：
| 请求头 | 值 |
|---|---|
Authorization | Bearer YOUR_API_KEY |
Content-Type | application/json |
在 API 密钥 页面获取你的 API 密钥。
#端点
POSTGETPOSTGET
生成视频
/v1/video/generations
提交异步视频生成任务
查询视频任务
/v1/video/generations/{task_id}
轮询任务状态并获取生成的视频
上传文件
/v1/files
上传参考媒体（multipart 表单）
POST
POST对话补全
/v1/chat/completions
兼容 OpenAI 的大模型对话
生成图片
/v1/images/generations
兼容 OpenAI 的图片生成
模型列表
/v1/models
当前密钥可用的模型
视频生成是异步的：提交后会返回一个 task_id，随后轮询该任务，或设置 metadata.callback_url 来接收 webhook 回调。视频生成指南完整讲解了整个流程。
#错误码
| 状态码 | 含义 |
|---|---|
400 Bad Request | 参数缺失或无效 |
401 Unauthorized | API 密钥缺失或无效 |
403 Forbidden | 额度不足或权限问题 |
404 Not Found | 未知的模型 ID 或任务 ID |
429 Too Many Requests | 超出速率限制 |
5xx Server Error | 上游或网关错误，请退避后重试 |
详细说明和重试方案见 错误码。