数据仪表盘

实时掌握星河视频工厂的生产与运行状况

今日生成视频

–

进行中任务

–

工作机在线

–

模板调用总量

–

累计消费

–

系统负载

–

排队等待

–

视频生成趋势

每日生成完成任务

模板调用量 / 消费

每日调用每日消费(¥)

工作机在线峰值

在线数

每日新建任务

新建任务

工作流水日志

全部已读

工作流模板

管理 CD / MV 类视频生产模板，配置素材需求与一键成片测试

全部0

CD0

MV0

特效插件模板

管理 player / 水印 / 特效插件库，上传后工作机自动同步（「滤镜」分类即自用 LUT 调色库）

插件清单

插件库版本 —

制片数字孪生

全系统实时镜像 · 甲方推送 → 素材接入 → AI 生成集群 → 质检超分 → 渲染集群 → 交付回传

● LIVE

在途镜头

刷新

镜头	作品	时长	状态	更新于

系统事件流

任务队列

三栏实时显示：待处理、进行中与历史生成记录

待处理0

任务号	客户	操作

正在处理0

任务号	进度	操作

历史队列0

任务号	操作

已生成资产库

展示全部已生成作品，作品生成后缓存 7 天，到期自动清理

API 接口

OpenAI 风格开放接口：视频生成、进度查询与余额查询

对外公开清单页（免登录 · 可直接发给甲方 / 接入方）

🎨 LUT 调色滤镜库（204 款 · 黑底效果图 + 实测参数）：lut-library.html 打开 ↗

🎤 歌词样式清单（156 款 · 真实引擎实时预览）：lyrics-catalog.html 打开 ↗

🔤 字体库清单（65 款 · 真实字体渲染样例）：fonts-catalog.html 打开 ↗

🎬 转场库（49 种 · ffmpeg 真实渲染预览）：transition-catalog.html 打开 ↗

调用日志

接口文档

调用示例 · POST /v1/video/generations

200 OK

# 鉴权：Bearer <你的连接码(API_KEY)> curl -X POST "https://你的域名/v1/video/generations" \ -H "Authorization: Bearer <API_KEY>" \ -H "Content-Type: application/json" \ -d '{' "template_id": "CD-2024-005", "prompt": "周年庆主题曲", "resolution": "1080P" }'

字段说明：template_id 工作流模板编号 · prompt 任务描述 · resolution 输出分辨率（720P / 1080P）。点击「复制示例」可直接复制 curl 命令。

响应示例（OpenAI 风格）

200 OK

{ "object": "video.generation", "id": "T-20260809-7pdf7c", "created": 1786257420, "model": "xinghe-cd-c1", "status": "queued", "template_id": "CD-2024-005", "resolution": "1080P", "watermark": true, "estimate_seconds": 420, "usage": { "quota": 5000, "used": 3403, "remaining": 1597 } }

GET /v1/user/balance · GET /v1/video/generations/{id}

# 查询余额 curl "https://你的域名/v1/user/balance" \ -H "Authorization: Bearer <API_KEY>" # ⇒ { "object":"balance", "quota":5000, "used":3403, "remaining":1597, "currency":"次" } # 查询任务进度 curl "https://你的域名/v1/video/generations/123" \ -H "Authorization: Bearer <API_KEY>" # ⇒ { "object":"video.generation", "id":"123", "status":"done", "progress":100, "result":{...} }

请求参数

参数	类型	必填	说明
`template_id`	string	是	工作流模板编号。传 MV 模板（如 MV-2025-001）即进入 MV 流程（图生视频），与 CD 同一接口
`prompt`	string	否	任务名称 / 描述
`materials`	array	否	所需素材列表：poster / cover / 原唱 / 伴奏 / 相册图 / 用户头像
`resolution`	string	否	输出分辨率，默认 1080P（720P / 1080P）
`watermark`	boolean	否	是否叠加水印，默认 true
`callback`	string	否	生成完成后的回调通知地址
`priority`	int	否	任务优先级 1-5，默认 3

MV 任务（图生视频）

MV 与 CD 使用完全相同的接口与素材包交付方式，差异仅两点：① template_id 传 MV 模板编号；② 素材包内额外包含三个 MV 专有文件。服务端识别后自动增加「图生视频」阶段：逐镜头 AI 生成视频片段并替换原图，随后进入与 CD 相同的渲染合成。

MV 专有文件	说明
`01-镜头图/`	每镜头一张底图（1920×1080），文件名序号即镜号（001.png、002.png…）
`02-镜头脚本.csv`	列：镜号 / 视频提示词 / 时长(秒) / 歌词（列名宽容匹配）
`06-视频生成要求.txt`	分辨率 / 帧率 / 编码 / 水印约束（如「不得出现水印」则成片不叠水印）

MV 流程状态	说明
`mv_stage=i2v`	镜头生成阶段：AI 工作机逐镜图生视频（可经 `GET /v1/video/generations/:id` 的任务详情观察）
`mv_stage=assemble`	片段替换原图完成，进入渲染合成（与 CD 相同）

响应字段

字段	类型	说明
`code`	int	0 表示成功，非 0 为错误码
`message`	string	结果描述
`data.task_id`	string	本次任务唯一 ID，用于查询进度
`data.status`	string	任务状态：queued / rendering / done / failed
`data.estimate_seconds`	int	预估生成耗时（秒）

错误码

HTTP	错误码	说明
401	`authentication_error`	缺少或无效的 API Key
403	`permission_error`	账户已停用
400	`invalid_request_error / 4004`	template_id 缺失或模板不存在
402	`quota_error / 4029`	账户额度不足
404	`not_found_error`	任务不存在或不属于当前账户
500	`server_error / 5000`	服务端内部异常

API 调用日志

刷新

时间	调用者	IP 地址	服务 / 模板	任务 / 工作机	状态	耗时

设置

工作机、客户、委托商与基础资料管理

基本设置

客户设置

平台概览

刷新

加载中…

-

兜底资料

客户/模板未提供素材时使用的默认品牌信息

品牌名称

兜底 Logo

兜底封面

MV 生成帧模式

切换后对新领取的镜头生效，进行中的镜头不受影响

MV 默认转场

镜头衔接效果（目录 — 项，由 /api/transitions 下发）。甲方 mv-shots.json 逐镜声明优先级更高；未声明镜头使用此处默认。保存后对新渲染的任务生效

工作机设置

渲染机与 AI 生成机的在线状态、权重并发、版本一致性管理

名称	ID	类型	持续在线时间	成功生成任务数	权重/并发	软件版本	状态	操作

外部大模型

生图 / 生视频 / LLM 供应商与模型优先级（多供应商依次 failover）

生图大模型

视频大模型（图生视频）

LLM（大语言模型）

生图大模型

按供应商顺序 × 模型顺序依次优先采用，失败自动降级到下一个

星河字画

歌词 → 文字 PV 自动构成（XINGHE v0.10.1 简体中文版）· 860 个部件 / 27 种风格 · 导出 MP4、连番 PNG、透明 PNG、AE 用 JSON

新窗口打开 ↗

数据仪表盘

排队拥堵提醒

视频生成趋势

模板调用量 / 消费

工作机在线峰值

每日新建任务

工作流水日志

工作流模板

特效插件模板

插件清单

制片数字孪生

在途镜头

系统事件流

任务队列

已生成资产库

API 接口

对外公开清单页（免登录 · 可直接发给甲方 / 接入方）

调用示例 · POST /v1/video/generations

响应示例（OpenAI 风格）

GET /v1/user/balance · GET /v1/video/generations/{id}

请求参数

MV 任务（图生视频）

响应字段

错误码

API 调用日志

设置

客户管理

平台概览

兜底资料

工作机设置

外部大模型

生图大模型

视频大模型（图生视频）

LLM 供应商（大语言模型）

星河字画