0
历史总任务
0
生成成功
0
生成失败
0%
成功率
0
运行中
0
排队中
成功 / 失败占比
各机器生成量
机器数据
机器名称
成功
失败
总计
成功率
状态
生成记录
点击行查看详情 · 视频文件 1 小时后自动清理，但记录永久保留| 任务 ID | 提示词 | 模式 | 模型 | 状态 | 机器 | 耗时 | 提交时间 |
|---|
0 / 0
＋创建模型
模型是"对外能力"：设置名字、后端模型名（Worker 侧映射）、支持的分辨率与最大时长。显卡绑定模型后，按此模型提交的任务只会派给绑定了它且能力满足的显卡。
| 模型名 | 后端模型 | 分辨率 | 最大时长 | 绑定显卡 | 操作 |
|---|
调度规则：任务指定模型后，只派发给绑定了该模型且能力（分辨率/时长）满足的在线空闲显卡；未指定模型的旧式任务派给任意空闲显卡。分辨率 480p=864×480、720p=1280×720、1080p=1920×1080，也支持自定义 WxH。
| 任务 ID | 模式 | 素材 | 状态 | 节点 | 耗时 | 结果 | 操作 |
|---|
API 说明文档
视频生成接口完整指南 · 支持一键复制所有示例
本服务对外提供两套兼容主流中转站的视频生成接口：OpenAI 风格（
/v1/videos）与 火山方舟风格（/api/v3/contents/generations/tasks），以及一套面板原生的 表单上传 接口。所有接口均支持三种认证方式，生成结果在视频文件被清理（1 小时）后仍可通过记录接口查询历史。
认证方式
| 方式 | 说明 |
|---|---|
| 登录会话 Cookie | 浏览器面板登录后自动携带，适合在面板内操作。 |
| Authorization Bearer | 请求头 Authorization: Bearer <操作令牌或 sk- 密钥>，中转站/外部系统推荐。 |
| URL 查询参数 | 请求 URL 追加 ?token=<操作令牌>，适合无法设置请求头的场景。 |
默认操作令牌为 dev-token（可在下方「连接信息」修改）；中转站请在「API 密钥」生成 sk- 开头的独立密钥。素材均支持 公网 URL 与 data URI。
认证方式
三种认证方式，适配不同调用场景
认证方式一览
| 方式 | 说明 |
|---|---|
| 登录会话 Cookie | 浏览器面板登录后自动携带，适合在面板内操作。 |
| Authorization Bearer | 请求头 Authorization: Bearer <操作令牌或 sk- 密钥>，中转站/外部系统推荐。 |
| URL 查询参数 | 请求 URL 追加 ?token=<操作令牌>，适合无法设置请求头的场景。 |
默认操作令牌为 dev-token（可在「系统设置」修改）；中转站请在「系统设置 → API 密钥」生成 sk- 开头的独立密钥。素材均支持 公网 URL 与 data URI。
OpenAI 风格接口
兼容主流中转站的 /v1/videos 接口
POST/v1/videos创建视频任务（异步）
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 画面描述提示词 |
| model | string | 虚拟模型名（模型管理中创建），留空或 MiniMax-H3 表示不限 | |
| size | string | 分辨率 WxH，如 864x480 | |
| duration | number | 时长（秒），与 frames 二选一 | |
| frames | number | 帧数（默认 362），未给 duration 时使用 | |
| fps | number | 帧率，默认 24 | |
| steps | number | 采样步数，默认 20 | |
| seed | number | 随机种子，-1 为随机 | |
| mode | string | i2v 首帧图生视频 / ref 多素材参考 / t2v 文生视频（留空自动判断） | |
| first_frame_image | string | 首帧图片 URL/data URI（i2v 必填） | |
| reference_images | string[] | 参考图片 URL 数组 | |
| reference_videos | string[] | 参考视频 URL 数组 | |
| reference_audios | string[] | 参考音频 URL 数组 |
bash请求示例
json创建返回
查询用
GET /v1/videos/{id}，状态值：queued → processing → succeeded/failed；成功后返回 video_url 直接下载。火山方舟风格接口
兼容火山方舟 / 豆包风格的视频生成接口
POST/api/v3/contents/generations/tasks创建视频任务（异步）
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 虚拟模型名，留空或 MiniMax-H3 表示不限 | |
| content | array | 是 | 内容数组，元素 type 为 text / image_url / video_url / audio_url |
| generation_config | object | 生成参数：width,height,duration,frames,fps,steps,seed,size,mode |
bash请求示例
json创建返回
查询用
GET /api/v3/contents/generations/tasks/{id}，状态值：queued → running → success/failed；成功后取 content[0].video_url.url。表单上传接口
面板原生的 multipart 表单上传方式
POST/api/tasksmultipart 表单上传素材提交任务
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 提示词，支持 @图1/@视频2 引用素材 |
| files | file[] | 素材文件（多选），按类型自动分类图/视频/音频 | |
| mode | string | i2v / ref / t2v | |
| model | string | 虚拟模型名（绑定调度） | |
| resolution | string | 480p/720p/1080p/WxH | |
| duration | number | 时长（秒） | |
| width / height | number | 自定义宽高（默认 864×480） | |
| first_frame | string | 首帧文件名（i2v） | |
| wait | number | 1 同步等待完成（默认异步） |
bash请求示例
json返回示例
查询与下载
任务状态查询与结果下载
GET/api/tasks/{id}查询任务详情（含历史记录）
GET/api/tasks/{id}/result下载生成的视频文件
GET/api/tasks任务列表（可按 status 筛选）
GET/api/state看板实时数据
GET/api/stats统计与生成记录（分页）
bash查询与下载
视频文件在任务完成 1 小时后自动清理，但任务记录（状态/耗时/提示词/错误）永久保留，可随时通过
/api/tasks/{id} 或 /api/stats 查询。Python 完整示例
从创建任务到下载视频的完整流程
完整流程：创建任务 → 轮询状态 → 下载视频。建议轮询间隔 5~10 秒。
pythonrequests 轮询示例
状态码与错误
任务状态映射与 HTTP 错误码
任务状态映射
| OpenAI 风格 | 方舟风格 | 含义 |
|---|---|---|
| queued | queued | 排队等待空闲显卡 |
| processing | running | 显卡正在生成 |
| succeeded | success | 生成完成 |
| failed | failed | 生成失败（含 error 信息） |
HTTP 状态码
| HTTP 状态 | 含义 |
|---|---|
| 200 | 成功 |
| 400 | 参数错误（如分辨率/时长/模型不匹配） |
| 401 | 未认证或令牌/密钥无效 |
| 403 | token 无效（Worker 接口） |
| 404 | 任务/文件不存在或已被清理 |
失败任务的查询响应中包含
error 字段说明原因。部署指南
从零搭建 GPU 集群视频生成系统
架构概览
1. 每台云端显卡运行一个 worker.py（自动注册节点、心跳上报 GPU 状态）；
2. 本机运行 rev_tunnel.py 建立反向隧道（云端 8010 → 本地 8000）；
3. 在「提交任务」页上传 933 素材包（9 图 + 3 视频 + 3 音频），系统自动分配给空闲节点；
4. 生成完成后结果自动回传，在「任务管理」页下载；
5. 节点 40 秒无心跳自动标记离线，其运行中任务自动回到队列；
6. 素材与结果保留 1 小时后自动清理。
2. 本机运行 rev_tunnel.py 建立反向隧道（云端 8010 → 本地 8000）；
3. 在「提交任务」页上传 933 素材包（9 图 + 3 视频 + 3 音频），系统自动分配给空闲节点；
4. 生成完成后结果自动回传，在「任务管理」页下载；
5. 节点 40 秒无心跳自动标记离线，其运行中任务自动回到队列；
6. 素材与结果保留 1 小时后自动清理。
添加节点
「节点管理 → 添加节点」支持两种接入：新建（面板生成密钥，Worker 带
--node-key 上线）或 绑定已有密钥（云端 Worker 启动日志打印的密钥，填入面板登记）。模型与调度
调度规则：任务指定模型后，只派发给绑定了该模型且能力（分辨率/时长）满足的在线空闲显卡；未指定模型的旧式任务派给任意空闲显卡。分辨率 480p=864×480、720p=1280×720、1080p=1920×1080，也支持自定义 WxH。
连接信息
0
API 总调用
0
OpenAI 风格
0
方舟风格
0
活跃密钥
0
今日调用
—
调用最多
近 14 天调用趋势
接口调用占比
密钥管理
点击密钥可筛选其调用记录| 名称 | 密钥前缀 | 调用次数 | 状态 | 创建时间 | 最后使用 |
|---|
请求历史
| 时间 | 接口 | 方式 | 路径 | 调用方 | 任务 ID | 状态 | 错误 |
|---|
0 / 0