创建 Token
在用户控制台创建 API Token，仅保存到服务端环境变量。
SEED VIDEO PLATFORM
视频生成业务接口
使用统一接口提交文本、图片、视频与音频素材，异步获取最终成片。您不需要感知 StarAI、对象存储或后续处理服务。
多模态视频与音频参考能力正在进行本地验收。本页面为接入预览，正式开放后将移除此提示。
快速开始
只需三个业务步骤
提交任务
文本可直接提交；素材调用 SDK 上传后作为输入引用。
轮询并下载
任务成功后获取短期有效的 output_url 下载成片。
GET
/v1/credits/balance提交任务前查询可用积分。
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
Idempotency-Key: your-business-order-id工作流
素材上传对业务方是一项操作
SDK 的 upload_asset / uploadAsset 会自动完成签名地址申请、文件直传和上传校验。调用方只拿到可用于任务的 asset_id。
本地素材SDK 上传asset_id创建任务最终视频
场景示例
七种多模态组合
文本在带素材的场景中可选。请在提示词中清楚说明每个参考素材的用途，例如“参考视频 1 的动作节奏，使用音频 1 作为背景音乐”。
图生视频
首帧与首尾帧
需要严格保持首帧或首尾帧一致时，使用 first_frame 和 last_frame。该模式不与 reference_* 多模态素材混用。
POST
/v1/video-tasks{
"prompt": "镜头从室内平稳移动到窗外夜景",
"inputs": [
{"asset_id": "首帧素材 ID", "role": "first_frame"},
{"asset_id": "尾帧素材 ID", "role": "last_frame"}
]
}接口参考
素材
/v1/assets/upload-requestsSDK 内部使用，申请本地文件的对象存储上传地址。
/v1/assets/url-imports导入公开 HTTP(S) URL 的图片、视频或音频素材。
/v1/assets查询当前用户已上传的素材及其 preview_url。
接口参考
视频任务
/v1/video-tasks创建异步生成任务。建议每次都传唯一的 Idempotency-Key。
/v1/video-tasks/{task_id}查询任务状态。每 5 至 10 秒轮询，直到 succeeded 或 failed。
/v1/video-resolutions查询当前开放的输出档位，客户端应以此结果为准。
错误处理
统一错误格式
{
"code": "VALIDATION_FAILED",
"message": "At least one of prompt or inputs is required",
"request_id": "client-request-000001"
}请保存响应头或响应体中的 request_id，排查问题时提供给支持人员。任务本身的生成失败通过任务状态 failed 返回，不会表现为 HTTP 请求失败。
SDK
可运行示例
仓库中提供只依赖标准库的 Python 客户端，以及基于 JDK HttpClient 和 Jackson 的 Java 客户端。多模态示例已覆盖本页全部七种组合。
Python：examples/pythonJava：examples/java