跳转到主要内容
视频生成需要几分钟,因此以任务方式运行:提交任务后立即拿到任务 ID,然后查询任务直到完成。接口与兼容 Seedance 的 SDK 使用的任务接口一致:
  • POST https://api.omnirelay.ai/api/v3/contents/generations/tasks 提交任务。
  • GET https://api.omnirelay.ai/api/v3/contents/generations/tasks/{id} 查询任务。
请用 OmniRelay API Key 作为 Bearer token。Key 的规则与文本模型相同:有效期、IP 白名单、模型限制、预算以及速率与并发限制。运行中的任务计为一个进行中的调用。你也可以先在控制台的模型体验中试用视频模型。

模型

视频模型会出现在你自己的 GET /v1/models 列表中,带有 type: "video" 以及你所在工作区的价格。

价格

视频按实际生成的输出 tokens 计费,标价为每百万输出 tokens USD 25。tokens 数由画面尺寸和时长决定:
一段 5 秒、480p、16:9(864 × 496)的视频是 50,638 tokens,约 USD 1.27。10 秒 720p 视频按画面比例不同约 USD 5.2–5.7。你的折扣与文本模型一样生效。 提交时,OmniRelay 会按所选分辨率下最大画面和时长再加 10% 预留费用。任务成功后按实际生成的 tokens 扣费,预留的剩余部分退回余额。**失败、过期或取消的任务不收费。**任务结果中的 cost_microusd 是本次费用。详见用量与计费。

提交任务

提交成功返回 {"id": "<任务 ID>"}。请保存这个 ID,它同时也是用量日志里的请求 ID。

参数

只接受下列字段,其他字段一律返回 400 invalid_parameter,因为每个接受的字段都可能影响价格。 暂不支持图生视频(首帧或尾帧)。

查询任务

GET /api/v3/contents/generations/tasks/{id} 返回任务。只有创建任务的用户可以查询;其他 ID 一律返回 404。
content.video_url 是签名链接,在视频生成后 48 小时失效。如需保留请自行下载;OmniRelay 不保存副本。
计费不依赖你查询:即使没有人查询任务,任务完成后 OmniRelay 也会自动结算。

失败与扣费

被挂起的任务在重新提交前请先带上任务 ID 联系客服,避免同一段视频付两次费。

限制

  • 仅支持文生视频,每个任务一段文字描述。
  • 分辨率最高 720p,时长最长 10 秒。
  • 请求体不超过 64 KiB。