Video Gen API 开发者文档

使用指南火山兼容API OpenAI 兼容API 在线调试帮助支持

Video Studio 素材库概览

使用 REST API 管理 Seedance 图片、视频、音频和真人素材

Video Studio 素材库为 OpenAI Videos/Seedance 工作流提供 11 个 REST 接口。所有接口使用与 /v1/videos 相同的 NewAPI Bearer API Key。

Authorization: Bearer sk-your-api-key

API Key 隔离

素材空间按 API Key 的 Token ID 隔离。同一账号下的不同 API Key 拥有不同的素材空间；创建、查询和视频生成应使用同一把 Key。

接口范围

分类	接口
素材组	列表、详情、修改名称和封面、删除
文件上传	创建新组上传、向已有组追加、删除单个素材
URL 导入	单 URL/base64 图片、最多 50 条批量 URL
真人素材	创建授权会话、同步 `LivenessFace` 素材组

统一响应

成功响应：

{
  "data": {},
  "error": null,
  "request_id": "req_xxx"
}

失败响应：

{
  "data": null,
  "error": {
    "code": "invalid_request",
    "message": "request is invalid"
  },
  "request_id": "req_xxx"
}

素材库使用该统一包装；/v1/videos 仍使用 OpenAI 风格响应。

素材状态

状态	说明
`Processing`	移动云正在处理，暂不可用于视频生成
`Active`	处理完成，可以将 `assetUrl` 用作参考素材
`Failed`	处理失败，从 `errorCode` 和 `errorMessage` 读取原因

创建或导入素材后，应轮询素材组详情，直到素材进入 Active 或 Failed。

文件与 URL 限制

类型	支持格式
图片文件	`.jpg`、`.jpeg`、`.png`、`.webp`
视频文件	`.mp4`、`.mov`
音频文件	`.mp3`、`.wav`
base64 图片	JPEG、PNG、WebP data URL

默认批量上传上限为 20 个文件，单文件上限为 200 MiB；实际值以服务端配置为准。
批量 URL 导入一次最多 50 条，不能包含空字符串。
base64 仅支持图片，且 assetType 必须为 Image。

推荐流程

使用文件上传或 URL 导入创建素材。
保存 groupId 和 assetId。
查询素材组详情，等待素材状态变为 Active。
读取素材的 assetUrl。
将 URL 放入 OpenAI 视频请求的 image、images 或 metadata.content。
创建并轮询 Seedance 2.0 视频任务。

错误码

code	HTTP	说明
`missing_newapi_key`	401	未提供 Bearer API Key
`invalid_newapi_key`	401/403	API Key 无效、禁用、过期或无素材权限
`newapi_unavailable`	502/5xx	API Key 校验暂时不可用
`invalid_json`	400	JSON 请求体无法解析
`invalid_request`	400	参数、文件类型、文件大小或字段组合不合法
`asset_url_required`	400	缺少 URL，或批量列表包含空 URL
`too_many_urls`	400	URL 数量超过 50
`not_found`	404	素材组或素材不存在，或不属于当前 API Key
`asset_conflict`	409	素材状态或资源归属冲突
`ecloud_proxy_not_configured`	503	移动云或素材暂存服务未配置
`ecloud_proxy_error`	502	移动云返回错误或响应异常

最后更新于

错误码

Seedance OpenAI Videos 请求校验、任务和下载错误

列出素材组

下一页

目录

文件与 URL 限制