视频生成与资产管理

使用 Kling v4 与 Seedance 模型生成视频,并引用已授权的媒体资产。

通过原生视频接口提交视频生成任务并管理已授权的媒体资产。

POST/v1/videos

请求体

字段类型必填说明
promptstring是描述所需视频场景、主体与运动运镜的提示词文本。
modelstring否视频模型标识符,例如 kling-v4 或 doubao-seedance-2-0-260128。
duration_secondsnumber否视频生成时长(秒,正数值最高 300 秒,同时兼容 duration 别名)。
Additional fieldsobject否视频扩展参数(如 resolution、aspect_ratio、first_frame_url、last_frame_url)透明透传至底层引擎。

Seedance 授权资产

POST/v1/seedance/assets
GET/v1/seedance/assets/{asset_id}
  • 资产注册:调用 POST /v1/seedance/assets(operationId: seedance_assets.create)并传递包含必填 sourceUrl、assetType(image 或 video)及可选 displayName 的 JSON 载荷。
  • URI 引用:在帧图像 URL 或高级参数中直接使用 asset://{asset_id} 进行跨模态引用。
  • 租户隔离:授权资产严格隔离在租户当前资产库中,并在提交前与上游存储完成权限校验。

任务状态与产物下载

GET/v1/videos/{task_id}
  • 状态轮询:通过 GET /v1/videos/{task_id}(operationId: legacy_media.video.get)查询任务实时状态,支持 queued、submitting、submitted、running、ingesting_artifacts、cancel_requested、completed、failed 及 cancelled 等 9 种状态。
  • 产物下载:任务成功完成后通过 GET /v1/videos/{task_id}/content 下载视频二进制文件。
  • Kling v4 支持:完整支持文生视频、首帧图生视频以及尾帧转场过渡模式。

兼容路径

  • 历史媒体别名:POST /openai/v1/videos 是 POST /v1/videos 的历史媒体别名(legacy_media.video.create.alias),遵循相同请求结构。
  • 历史生成任务路由:POST /v1/videos/generations 接收 CreateVideoGenerationRequest 格式载荷。
  • 统一异步管道:POST /v1/async-tasks/video-generations 提供标准化的 v4 异步任务生命周期契约。