Laravel 队列任务生成 AI 视频：PHP 接入 RelayDance API

在 Laravel 中生成 AI 视频，可将 RelayDance 的 OpenAI 兼容接口封装进队列任务：在 Job 中用 HTTP 客户端向 POST /v1/video/generations 提交 model、prompt 与 seconds，随后轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded 或 failed，或改用 metadata.callback_url 回调。base_url 设为 https://relaydance.com/v1，鉴权用 Authorization: Bearer YOUR_API_KEY。计费按生成时长计算，失败请求不计费。

为什么用队列任务处理视频生成

视频生成属于长耗时任务，适合放进 Laravel 队列异步执行。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此在 PHP 端只需替换 base_url 与 API Key。队列 Job 负责提交任务并轮询状态，避免阻塞 HTTP 请求。剪辑长度支持最长 15 秒，每次请求最多可引用 9 张参考图、3 段参考视频和 3 条音轨。计费为按量付费，失败或报错的请求不计费，重试逻辑因此更安全。参见 https://relaydance.com/docs。

在 Job 中提交与轮询任务

提交任务时向 POST /v1/video/generations 发送 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio、callback_url、content[]）。参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用。提交后可轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded 或 failed，结果包含视频 url。若设置 metadata.callback_url，最终状态将被 POST 到你的服务器，队列任务可先入库再由 Webhook 更新。图像生成使用 POST /v1/images/generations。API Key 可在 https://relaydance.com/console 创建。

各模型价格与成本估算

不同模型与分辨率的单价不同，可用于队列任务的成本预算。Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。gpt-image-2 出图时图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此队列重试不会产生额外费用。实时费率见 https://relaydance.com/models。

PHP 接入步骤

下面是在 Laravel 队列任务中接入 RelayDance 的步骤：

1. 在 https://relaydance.com/console 创建 API Key，写入 .env。
2. 配置 HTTP 客户端 base_url 为 https://relaydance.com/v1，请求头带 Authorization: Bearer YOUR_API_KEY。
3. 在 Job 的 handle 方法中向 POST /v1/video/generations 提交 model、prompt、seconds。
4. 轮询 GET /v1/video/generations/{task_id}，或设置 metadata.callback_url 由 Webhook 接收最终状态。
5. 状态为 succeeded 后从结果读取视频 url 并入库。

常见问题 FAQ

需要 BytePlus 企业账号或 KYC 吗？不需要，RelayDance 提供直接的 OpenAI 兼容访问方式接入 Seedance。

任务失败会扣费吗？不会，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。

支持哪些支付方式？支持 USDT 和 Stripe 银行卡，计费为按生成视频的按量付费。