Docs / API 密钥

API 密钥

API 密钥用于为你发往 RelayDance API 的请求鉴权。每次调用都需要在 Authorization 请求头中携带有效密钥。

#创建 API 密钥

打开 RelayDance 控制台
进入 API 密钥页面并创建一个新密钥
复制你的新密钥并妥善保存

请像对待密码一样对待密钥。如果某个密钥可能泄露，请在控制台中删除它并创建一个新的。

#为请求鉴权

在每次请求中以 bearer token 的形式携带你的 API 密钥：

Authorization: Bearer YOUR_API_KEY

例如，提交一个视频任务：

terminalbash

curl https://relaydance.com/v1/video/generations \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-720p",
    "prompt": "A dancer spins in golden hour light, cinematic",
    "seconds": "5",
    "metadata": { "ratio": "16:9", "resolution": "720p" }
  }'

同一个密钥在所有端点上通用，包括视频任务提交、轮询，以及使用 gpt-image-2 的图像生成。任何兼容 OpenAI 的工具也都接受它：把基础 URL 设为 https://relaydance.com/v1（保留 /v1 后缀），再粘贴你的密钥即可。

#安全最佳实践

切勿分享你的 API 密钥，或将其提交到版本控制系统
将其保存在环境变量中：export RELAYDANCE_API_KEY="..."
把任何包含密钥的 .env 文件加入 .gitignore
定期轮换密钥：删除旧密钥并创建新密钥
为开发和生产使用不同的密钥
在控制台中监控用量，以发现异常活动

#密钥管理

在控制台中管理密钥：

操作	说明
`创建`	按需生成新的 API 密钥
`删除`	吊销不再需要或可能已泄露的密钥
`查看用量`	按密钥监控用量与花费

#速率限制

每个密钥都适用标准速率限制。如果你收到 429 Too Many Requests：

在请求之间加入短暂延迟
重试时采用指数退避
如需更高的限额，请联系 support@relaydance.com

←快速开始更新日志→