前台操作文档
本文档面向使用本平台生成视频 / 图片的终端用户,覆盖账号、模型选择、素材引用、任务提交与下载、计费与常见报错。管理端侧的操作请看 后台操作文档(需登录总后台)。
1快速开始
/video.php,用账号 + 密码登录。没有账号时点「注册」tab 自助注册,或向代理商索取注册链接(链接里的账号会自动归属该代理)。个人中心 / 帮助 / 各视频模型 / 过人脸图片。进哪个页就用什么模型。@图片1、@视频1、@音频1 引用它们。两套账本,先分清:余额用于生成视频 / 图片任务,算力值用于「AI 提示词」和「爆品复刻」。两者互不相通,余额够了不代表算力值够。
2账号
2.1 注册
登录页有 登录 / 注册 两个 tab。只有后台「系统配置 → 开放注册」打开时才会出现「注册」tab。
| 注册方式 | 入口 | 注册后 |
|---|---|---|
| 自助注册 | 直接点「注册」tab | 只建号,不自动登录,提示「注册成功!账号「xxx」已提交,请联系管理员开通后登录」。余额与权限由管理员开通。 |
| 代理注册 | 代理商给的注册链接(形如 /video.php?ref=xxxxxxxx,可再加 &act=reg 直接落到注册页) | 账号自动归属该代理商,注册即登录直接进工作台,余额由代理分配。 |
填写要求
- 账号:3–50 位英文 / 数字 /
._-,不能有空格和中文。 - 密码:至少 6 位。注册成功即自动生成一条
sk-开头的 API 密钥,在「个人中心 → API 密钥」里查看和复制,不可修改。 - 确认密码:两次要一致。
- 同一个 IP 1 小时最多注册 5 个,超了会提示「注册过于频繁,请 1 小时后再试」。
- 注册链接失效(代理被禁用或链接被重置)时,注册按钮置灰并提示「该注册链接无效或已失效,请向代理索取最新链接」。
2.2 登录与退出
- 登录只要「账号 + 密码」,不校验上游 Key,所以登录很快,不会因为上游抖动而登不进。
- 登录失败提示:「账号或密码错误」「账号已禁用」「请输入账号和密码」。
- 点右上角「退出」即退出登录(
?logout=1)。
2.3 个人中心(?tab=profile)
两张信息卡 + 四张流水表,全部是只读的,除了改密码。
sk-xxxx · 复制 · 接口文档| 记录表 | 看什么 | 类型 |
|---|---|---|
| 算力值记录 | 算力值的每一笔进出 | 管理员调整 / AI提示词扣费 |
| 余额记录 | 余额的每一笔进出;备注是任务号时会变成可点击的链接 | 管理员加款 / 任务扣费 / 失败退费 |
| 下载记录 | 自己下载过什么、什么时候 | 视频 / 图片 |
| 历史记录 | 自己提交过的所有任务 + 状态 + 扣费 | 排队中 / 生成中 / 已完成 / 失败 |
修改密码:填「原密码 + 新密码(至少 6 位)」→「提交修改」。成功后会自动退出并回到登录页,用新密码重新登录。
前台没有自助充值入口。余额和算力值都由管理员 / 代理商在后台发放,看到「余额不足」请找他们充值。
3模型能力总表
下表是当前代码里的硬约束,填错会被服务端拒绝(422)并提示具体原因,不会扣费。后台关掉某个模型或某个秒数后,对应的行 / 选项会直接从页面消失。
| 模型 | 时长 | 画幅 | 分辨率 | 参考图 | 参考音频 | 参考视频 | 提示词上限 |
|---|---|---|---|---|---|---|---|
| 933SD2.5 | 4–30 秒(逐秒可选) | 16:9、9:16、1:1、4:3、3:4 | 480p | ≤ 9 张 | ≤ 3 段(须搭配图或视频) | ≤ 3 条 | 10000 |
| 新SD2.5 | 5–30 秒(逐秒可选) | 16:9、9:16、1:1、4:3、3:4、21:9 | 1080p | ≤ 9 张 | ≤ 3 段(须搭配参考图,合计 ≤ 15 秒) | 不支持 | 10000 |
| 全参SD2.5专线1 | 5–30 秒(逐秒可选) | 16:9、9:16、1:1、4:3、3:4、21:9 | 720p(带参考视频 480p) | ≤ 30 张 | ≤ 10 段 | ≤ 10 条 | 10000 |
| 全参SD2.5专线2 | 4–30 秒(逐秒可选) | 16:9、9:16、1:1、4:3、3:4、21:9 | 720p | ≤ 30 张 | ≤ 10 段 | ≤ 10 条 | 10000 |
价格看页面。每个生成页底部会实时显示「模型 · 画质档 · 约 ¥X.XX」,以那里显示为准(价格由平台 / 代理商在后台配置,可能随时调整)。
看不到某个模型?三种可能:① 后台「菜单配置」把它关了;② 后台定价矩阵里这个模型的所有秒数都关了;③ 这个模型所属的专线还没在「模型key配置」里启用 Key。这时直接访问该 tab 会提示「该模型所属的 VIP专线X 暂未开通」。
4视频生成
适用模型:933SD2.5 新SD2.5 全参SD2.5专线1 全参SD2.5专线2。表单从上到下:
| 字段 | 必填 | 说明 |
|---|---|---|
| 提示词 Prompt | 必填 | 描述主体、动作、镜头、风格。支持中英文,右下角有字数计数(上限见总表)。 |
| 模型 | — | 只读,显示「标签 · 规格」。 |
| 时长 | 必填 | 下拉,默认落在最长的一档;只列出后台开启的秒数。 |
| 参考图 | 可选 | 多选上传,PNG / JPG / WebP,单张最大 10MB。 |
| 参考音频 | 可选 | MP3 / M4A / WAV / OGG / FLAC,单段 ≤ 50 MiB、合计 ≤ 60 MiB(全参SD2.5 两个专线合计 ≤ 100 MiB)。模型不收音频时整块不显示。 |
| 参考视频 | 可选 | MP4 / MOV / WebM,单条 ≤ 50 MiB、合计 ≤ 60 MiB(全参SD2.5 两个专线合计 ≤ 100 MiB)。只有全参SD2.5 两个专线收参考视频;专线1 带参考视频时画质自动降到 480p,专线2 保持 720p。模型不收视频时整块不显示。 |
| 画面比例 | 必填 | 按模型白名单过滤,9:16 / 16:9 / 1:1 / 4:3 / 3:4 / 21:9 等。 |
| 提交生成任务 | — | 提交中按钮变「正在提交……」。 |
提示词里怎么引用素材
上传完素材后,点提示词旁边的 引入素材 @ 可以把 @图片1 之类的编号插进提示词;也可以直接手打。规则见 素材与 @ 引用。
提交前会被本地拦下的情况
- 「请等待图片上传完成」「正在处理音频/视频,请稍候」—— 素材还没传完。
- 「最多 N 张图片 / N 段音频 / N 条视频」—— 超过当前模型能收的素材数量(上限见总表)。
- 「音频合计将超过 N MiB」—— 一次传的素材太大,分两次传或压小一点。
- 「参考音频必须搭配参考图或参考视频」—— 933SD2.5 这类模型不收单独的音频。
- 「余额不足,当前余额:X.XX 元,本次需要 Y.YY 元」—— 余额不够,不会提交。
提交成功会弹「任务已提交:<任务ID>」,表单自动清空,任务列表刷新并开始自动轮询。
5过人脸图片
- 只上传一张人物照片即可,PNG / JPG / WebP,单张最大 100MB。
- 选完立刻出缩略图,点「提交生成」排队。
- 完成后任务卡片上出现「下载图片」,文件名形如
portrait-123.png。 - 失败会自动退款,卡片上显示「生成失败,积分退回」。
6素材与 @ 引用
| 写法 | 指什么 |
|---|---|
@图片1 | 你上传的第 1 张参考图 |
@视频1 | 你上传的第 1 条参考视频 |
@音频1 | 你上传的第 1 段参考音频 |
- 三种类型各自从 1 开始编号(图 1、图 2…;视频 1、视频 2…)。
- 同一个编号重复引用同一份素材是允许的。
- 引用了不存在的编号会返回 422(提示词里写错编号)。
- 示例:
参考@视频2的运动,配合@音频1生成机器人走路的视频。 - 「引入素材 @」按钮会列出当前已上传的素材,点一下就把编号插到提示词光标处。
7AI 提示词助理 ✨
用大模型帮你写 / 改提示词。视频页有这个按钮(✨ AI 提示词),扣的是算力值不是余额;生成失败不扣。
三种模式
| 模式 | 适合 | 要填什么 |
|---|---|---|
| 润色 | 已有草稿,想改漂亮 | 提示词框里先写点东西,「你的想法」留空 |
| 看素材写词 | 已经有参考图 / 音视频 | 选素材、勾掉不要用的,点「生成提示词」 |
| 一键成片 | 一句话就想出成片 | 「你的想法」写一句话 |
面板上的其它东西
- 风格预设:后台配的一组风格 chip,单选,再点一次取消;不选就不注入风格。
- 规避内容:写「不要出现文字、水印、字幕」这类排除项,≤ 300 字。
- AI 用法建议:每个素材一条建议,取消勾选就把这个素材从提示词引用里剔除。
- 应用并填回:把建议里的素材引用写回提示词。
- 替换应用到提示词:生成完成后弹确认框,替换会覆盖提示词框现有内容,勾「取消」可以保留原文。
- ⚡ 一键成片:生成完自动提交付费任务,会先按任务价预检余额。
报错速查:「算力值不足(当前 X.XX,本次需 Y.YY),请联系管理员充值」→ 找管理员加算力值;「调用太频繁,1 分钟最多 10 次」→ 等一分钟;「AI 生成超时(75s 无响应),请重试」→ 点「↻ 重试」。
8爆品复刻 🎯
上传一条你想抄的成片,AI 把它拆成分镜表 + 提示词 + 关键帧参考图 + 原声音轨 + 台词,一键填回生成表单。同样扣算力值。
- 「视频 X.X 秒超过上限 N 秒,请剪短后再试」→ 素材太长了,先剪。
- 「复刻超时(150s 无响应),请重试」→ 点「↻ 重试」;超时和失败都不扣算力值。
- 「调用太频繁,1 分钟最多 2 条」→ 复刻比 AI 提示词限得更严。
9任务与下载
| 状态 | 含义 | 你要做什么 |
|---|---|---|
| 排队中 | 已受理,等 worker 开工 | 等 |
| 生成中 | 正在渲染 | 等 |
| 已完成 | 成片已就绪 | 点「下载 MP4 / 下载图片」 |
| 失败 | 生成失败 | 费用已原路全额退回,余额记录里会有一条「失败退费」 |
- 任务列表每次返回最近 50 条,只列当前模型的任务(换个模型 tab 就换一批),右上角「刷新」手动刷;页面也会自动轮询(图片 2.5 秒、视频 5 秒一次)。
- 下载接口按账号校验,别人的任务 ID 拿不到。
- 下载失败常见提示:「任务不存在或未完成」「未找到存储地址」「成片链接暂时取不到,请稍后重试」—— 后者等一会儿再试,别重新提交任务。
慢不等于失败。出片可能要几分钟到几小时。轮询期间不要重新提交,重新提交会重复扣费。
10余额与算力值
| 账本 | 扣什么 | 怎么来 | 失败退不退 |
|---|---|---|---|
| 余额 | 视频 / 图片生成任务 | 管理员或代理商发放 | 退(生成失败自动原路退回) |
| 算力值 | AI 提示词、爆品复刻 | 管理员或代理商发放 | 不扣(失败 / 超时都不算) |
- 两个账本互相独立,余额充足不代表算力值充足。
- 价格按「模型 × 时长」算,页面上会实时显示本次要扣多少,提交前也会校验余额。
- 代理商用户的实际成交价按该代理商的计费配置算(没配的项跟随总后台)。
11API 接入
网页和 API 是同一套后端、同一份余额。想在程序里批量生成,走 API 更合适。
Authorization: Bearer sk-你的密钥;请求域名就是本站 https://<站点>/apis.php?path=/<端点>。curl -sS -X POST '?path=/v1/videos' \
-H 'Authorization: Bearer sk-你的密钥' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: order-0001' \
-d '{"model":"newsd25","prompt":"雨后的街角,镜头缓慢前行","duration":10,"resolution":"1080p","ratio":"16:9"}'
- Idempotency-Key 强烈建议带:相同 Key + 相同请求体重复提交返回原任务,不重复扣费。
- 状态机:
queued → running → succeeded | failed,只有succeeded才给有效成片链接。 - 错误码速查:
402余额不足、409幂等冲突、422参数不合法、429限流、503通道繁忙。每个响应带X-Request-ID,报障时把它一起给技术支持。
12常见问题与报错对照
| 提示 | 原因 / 怎么办 |
|---|---|
| 请先登录 | 会话过期,重新登录一次。 |
| 账号或密码错误 | 账号填错或密码不对;别拿 API 密钥当密码。 |
| 注册功能已关闭 | 平台暂时关了自助注册,找代理商或管理员开号。 |
| 该注册链接无效或已失效 | 代理链接被重置或代理被禁用,向代理索取最新链接。 |
| 注册过于频繁,请 1 小时后再试 | 同 IP 1 小时注册超过 5 个。 |
| 余额不足,当前余额:X.XX 元 | 找管理员 / 代理商充值。 |
| 算力值不足(当前 X.XX,本次需 Y.YY) | 找管理员 / 代理商加算力值。 |
| 提示词引用了不存在的素材 @图片N | 提示词里的编号和实际素材数量对不上,核对编号或删掉引用。 |
| 参考视频 X.Xs + 生成 Ys = Z.Zs,超过 N 秒上限 | 参考视频和生成时长加起来超了,剪短参考视频或减少生成秒数。 |
| 该模型所属的 VIP专线X 暂未开通 | 平台还没给这个模型配 Key,等平台开通。 |
| 所有 tab 都已被管理员关闭 | 平台把所有功能页关了,联系管理员。 |
| 生成失败,积分退回 | 任务失败,费用已自动退回,不用重复提交。 |
| 成片链接暂时取不到,请稍后重试 | 成片还在生成或存储还没同步,稍后再点下载,不要重新提交。 |