视频生成与资产管理
使用 Kling v4 与 Seedance 模型生成视频,并引用已授权的媒体资产。
通过原生视频接口提交视频生成任务并管理已授权的媒体资产。
POST
/v1/videos请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt | string | 是 | 描述所需视频场景、主体与运动运镜的提示词文本。 |
model | string | 否 | 视频模型标识符,例如 kling-v4 或 doubao-seedance-2-0-260128。 |
duration_seconds | number | 否 | 视频生成时长(秒,正数值最高 300 秒,同时兼容 duration 别名)。 |
| Additional fields | object | 否 | 视频扩展参数(如 resolution、aspect_ratio、first_frame_url、last_frame_url)透明透传至底层引擎。 |
Seedance 授权资产
POST
/v1/seedance/assetsGET
/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 异步任务生命周期契约。