视频生成

所有 Relyven 视频模型共用一组异步端点。客户端只需通过 model 和模型参数区分 Seedance 与 Veo。

端点

操作	方法与路径
创建	POST /v1/videos
查询	GET /v1/videos/{task_id}
下载	GET /v1/videos/{task_id}/content

返回中的 id 是三步流程共用的任务 ID。状态为 queued、in_progress、completed 或 failed；进入 completed 后再下载 MP4。

能力对比

模型	生成方式与输入	输出	关键参数
doubao-seedance-2-0-260128	文生视频、参考视频续写；可传参考视频	480P、720P、1080P、4K	duration、画幅；无独立音频开关
veo-3.1-generate-preview	文生视频、首尾帧生视频；0–2 张首尾帧	720p、1080p；4、6、8 秒	16:9、9:16；必须传 generate_audio
veo-3.1-fast-generate-preview	与 Veo 3.1 相同，优先速度和成本	720p、1080p；4、6、8 秒	16:9、9:16；必须传 generate_audio

Seedance 2.0

doubao-seedance-2-0-260128 支持文生视频和参考视频续写，输出分辨率为 480P、720P、1080P 或 4K。

curl https://api.relyven.com/v1/videos \
  -H "Authorization: Bearer $RELYVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "A calm ocean at sunrise",
    "duration": 4,
    "metadata": {"resolution": "720P"}
  }'

参考视频放在 metadata.content，并标记 role: "reference_video"：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "自然延续这个视频",
  "duration": 4,
  "metadata": {
    "resolution": "720P",
    "content": [{
      "type": "video_url",
      "role": "reference_video",
      "video_url": {"url": "https://example.com/input.mp4"}
    }]
  }
}

Veo 3.1

支持 veo-3.1-generate-preview 和 veo-3.1-fast-generate-preview。duration 为 4、6 或 8；分辨率为 720p 或 1080p；画幅为 16:9 或 9:16。必须明确传入 metadata.generate_audio。images 可传零至两张 Data URL，依次作为首帧和尾帧。

curl https://api.relyven.com/v1/videos \
  -H "Authorization: Bearer $RELYVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "A paper boat floating on a quiet pond",
    "duration": 4,
    "metadata": {
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": false
    }
  }'

查询、下载与结算

curl https://api.relyven.com/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $RELYVEN_API_KEY"

curl https://api.relyven.com/v1/videos/$TASK_ID/content \
  -H "Authorization: Bearer $RELYVEN_API_KEY" \
  --output result.mp4

• Seedance 按供应商完成结果中的 total_tokens 和分辨率/参考视频档位结算。
• Veo 按任务完成时的实际秒数，以及模型、分辨率和音频档位结算。
• 最终金额以实时模型广场为准。终态 failed 或平台任务超时会退回预扣额度；客户端断线或本地轮询超时不会单独触发退款。
• 创建连接在返回 ID 前中断时，结果属于未知状态。请保留请求 ID 并先查询用量，避免重复提交付费任务。