用 curl 测试 Seedance API：每个接口的最小可用请求示例

用 curl 测试 Seedance API 只需三步：先向 POST https://relaydance.com/v1/video/generations 提交任务（携带 model、prompt、seconds），再轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded 或 failed，最后从返回结果读取视频 url。所有请求使用 Authorization: Bearer YOUR_API_KEY 认证，接口与 OpenAI 兼容，只需把 base_url 改为 https://relaydance.com/v1。失败或报错的请求不计费。

如何用 curl 提交一个视频生成任务

提交视频任务的最小请求是向 POST /v1/video/generations 发送 model、prompt 与 seconds 三个字段。示例如下：

• curl https://relaydance.com/v1/video/generations \
• -H "Authorization: Bearer YOUR_API_KEY" \
• -H "Content-Type: application/json" \
• -d '{"model":"seedance-2.0","prompt":"a cat walking","seconds":5}'

你可以在 metadata 中追加 ratio、resolution、generate_audio 与 callback_url。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此现有 OpenAI 代码几乎无需改动。单次请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，片段长度上限为 15 秒。API Key 可在 https://relaydance.com/console 创建。

如何用 curl 轮询任务状态并取回视频 url

提交后需向 GET /v1/video/generations/{task_id} 轮询，直到 status 变为 succeeded 或 failed。示例请求：

• curl https://relaydance.com/v1/video/generations/{task_id} \
• -H "Authorization: Bearer YOUR_API_KEY"

当 status 为 succeeded 时，返回结果中包含视频 url，可直接下载。如果你希望避免主动轮询，可在提交任务时设置 metadata.callback_url，任务的最终状态会以 POST 方式推送到你的服务器（Webhook 模式）。参考媒体放入 metadata.content[]，并在 prompt 中用 @image1 到 @imageN 引用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此测试轮询逻辑时无需担心因错误请求产生额外费用。

如何用 curl 调用图像生成接口

图像生成使用 POST /v1/images/generations，同样通过 Bearer Token 认证。示例：

• curl https://relaydance.com/v1/images/generations \
• -H "Authorization: Bearer YOUR_API_KEY" \
• -H "Content-Type: application/json" \
• -d '{"model":"gpt-image-2","prompt":"a red apple"}'

关于计费，gpt-image-2 的图像输出免费，只按输入计费；图生图约 ¥0.035 起，且 4K 与 1K 出图同价（来源 relaydance.com/models）。这意味着分辨率不会改变出图价格，测试不同尺寸时的成本可预期。支付方式支持 USDT 与 Stripe 银行卡，采用按量计费。实时的分模型费率请参见 https://relaydance.com/models。

各模型的每秒价格对比

不同 Seedance 模型的价格按秒或按条计费，具体如下表（来源 relaydance.com/models）：

以 5 秒视频为例：Seedance 2.0 720p 约为 $0.190 乘以 5，Seedance Fast 约为 $0.152 乘以 5，原生 4K 则按 $4.90 每条计价。计费为按生成视频付费，失败请求不产生费用。更完整的分辨率与音频参数说明见 https://relaydance.com/docs。

常见问题（FAQ）

问：base_url 需要怎么设置？据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此把 base_url 指向 https://relaydance.com/v1 即可。

问：请求失败会扣费吗？不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，计费仅针对成功生成的视频。

问：一次请求最多能带多少参考媒体？单次请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，片段长度上限为 15 秒，参考媒体放入 metadata.content[] 并在 prompt 中用 @image1 到 @imageN 引用。