让灵感有处可去。
登录你的专属空间,管理视频与积分。
账户中心
按时长 × 每秒积分计费,总价向上取整。提交前冻结积分,成功扣除、失败退回。提交结果未知时继续核实,不重复扣费。视频完成后仅保留 24 小时,到期自动清理,请及时下载;任务与积分明细保留。
在线充值
选择充值金额与支付方式,支付完成后自动到账。积分可用于网页和 API 视频生成。
充值订单
支付页面未完成时可在 30 分钟内继续支付。已付款但尚未到账时请稍后刷新,不要重复付款。
| 订单号 | 金额 | 积分 | 方式 | 状态 | 创建时间 | 操作 |
|---|
兑换码充值
输入管理员提供的积分兑换码,每个兑换码仅可使用一次。
历史使用明细
按时间倒序分页展示全部明细,每页 10 条。冻结/退款表示可用积分变动,消费表示已冻结积分结算。
| 时间 | 类型 | 积分 | 可用余额 | 冻结余额 | 任务编号 | 备注 |
|---|
我的视频
API Token 管理
Token 可代表你的账号生成视频并消耗积分,仅能查询和下载你的数据,无法操作管理后台。完整 Token 仅在创建时显示一次,服务端仅保存摘要;请勿放在前端代码或公开仓库中。
请立即复制保存,关闭后无法再次查看完整 Token。
| 名称 | Token 标识 | 创建时间 | 到期时间 | 最近使用 | 状态 | 操作 |
|---|
OpenAI 兼容接入
Chat Completions用于支持 OpenAI 协议的第三方客户端或你自己的后端。此模型生成视频,不是通用聊天模型;网页创作功能不受影响。
API 地址(Base URL):
API Key:上方创建的 Token · 协议:OpenAI Chat Completions · 模型:minimax-h3
模型列表:GET /v1/models;单个模型:GET /v1/models/minimax-h3;生成:POST /v1/chat/completions。也兼容 /api/v1 前缀。
新增 MiniMax H3(备用):模型 ID minimax-h3-backup,独立云端通道,不依赖本地工作台。异步生成请求传 model,Chat 请求使用顶层 model。支持4/6/8秒(最多8图)或15秒(最多7图、720p、16:9或9:16固定画幅1344×768或768×1344);当前最多1段参考视频和1段音频。素材须先暂存本站。备用通道提交结果未知时不会自动重复生成,请按原任务ID查询或联系管理员。本站积分单价及审核/优化规则不变。
调用示例(推荐流式)
使用 Python SDK 时,将 video 放入 extra_body;JavaScript SDK 或原生 HTTP 请求中使用顶层 video 字段。部分客户端不能填写额外参数时,采用默认值:15 秒、720p、16:9。时长不会从自然语言自动推断。
| 字段 | 说明 |
|---|---|
| messages | 取最后一条 user 消息作为视频提示词,支持字符串或 text 内容块;不会把系统消息和历史聊天拼进提示词 |
| stream | true 为 SSE;false 返回普通 chat.completion |
| video.duration | 1–15 整数秒,默认15;按实际秒数消耗积分 |
| video.resolution / ratio | 480/720/1080;16:9、9:16、1:1、4:3、3:4 |
| video.queue / optimize_prompt | 布尔值,均默认 true;false 分别关闭排队/提示词优化 |
| video.media / workspaceId | 使用下方异步 API 暂存获得的本人素材 ID;暂存素材由队列自动分配工作台 |
自动排队与提示词优化默认开启。video.queue=false 关闭资源排队;video.optimize_prompt=false 使用原始提示词。两项只接受布尔值。排队/优化期间不冻结积分,真正提交前再次检查并冻结;优化失败或需要补充信息时停止,不使用原文继续生成。
网页和 API 视频生成默认进行文字提示词内容安全检测;管理员可在后台调整新任务的检测设置,调用方不能通过参数关闭。检测启用时,原文及优化后的最终提示词都须通过;不通过或检测服务异常时不提交生成、不扣生成积分。此检测仅针对文字,不表示参考素材画面或最终视频已经审查。
返回与长任务
流式响应使用 chat.completion.chunk、delta.content 和 data: [DONE],等待期间每10秒心跳,最多等待1小时。普通响应最多等待110秒;仍未完成时明确返回“处理中”,不会伪造视频结果。
响应扩展字段 frame 包含 task_id、status、credits、duration 和 request_id。等待到期后可使用下方异步状态接口继续查询,或携带原 Idempotency-Key 和相同参数重新等待。客户端应允许足够长的超时;断开连接不取消已受理任务。
完成后在 assistant 文本中返回视频下载链接。链接只授权该视频,有效期最多1小时,关联 Token 撤销或到期后立即失效;链接持有人可读取该视频,请勿公开转发。视频本身仍仅保留24小时。不同客户端是否直接播放视频取决于客户端支持情况。
沿用当前每秒积分价格,余额不足返回402;不按聊天 Token 计费,usage 中的 Token 数为0。每次未携带幂等键的调用都视为新任务,可能重复消费;建议业务调用始终设置唯一 Idempotency-Key,同一任务重试保持原键。默认无空闲工作空间时进入服务端持久队列,最长等待1小时;video.queue=false 时返回409,尚未扣费。
当前不支持工具调用、JSON强制输出、直接 image_url / 音频内容块;参考素材请使用上传接口并传入 video.media,不会抓取请求中的外部素材网址。服务端脚本调用无需 Cookie,不开放浏览器跨域直连。
API 使用说明
基础地址:。所有请求均使用 Authorization: Bearer YOUR_TOKEN。不需要 Cookie;Token 不能创建新 Token、充值或操作管理员接口。不支持跨域浏览器直连,请在你自己的后端或脚本中调用。
1. 查询余额
2. 生成视频
提交前冻结积分,成功扣除、明确失败退回。当前按管理员设置的每秒积分计费,总价向上取整;默认 5 积分/秒,15 秒 75 积分。
| 参数 | 说明 |
|---|---|
| prompt | 必填,原始或优化后提示词,最多 20000 字 |
| duration | 0.01–15 秒,默认 15;数字类型 |
| resolution | 480 / 720 / 1080,默认 720;数字类型 |
| ratio | 16:9 / 9:16 / 1:1 / 4:3 / 3:4,默认 16:9 |
| queue | 布尔值,默认 true;无空闲资源时持久排队,最长1小时。false 时不等待资源 |
| optimize_prompt | 布尔值,默认 true;生成前自动优化。false 直接使用原文,优化失败不会静默回退 |
| media | 可选,已上传素材 ID 数组;按数组顺序分配图片,最多 9 图、1 视频、1 音频 |
| workspaceId | 可选,工作空间 ID(字符串);有素材时自动沿用素材的工作空间 |
必须提供 8–100 位 Idempotency-Key:同一次任务重试时保持相同参数和相同键,新任务必须换新键。返回 HTTP 202:{"id":"稳定任务 UUID","status":"waiting"}。提交超时或 5xx 可能已受理,请使用原键确认,不能改键盲目重发。
3. 查询进度与下载
状态:moderating(内容安全检测)、waiting(等待空闲工作台)、optimizing(提示词优化)、queued(云端排队)、importing(准备)、running(生成)、downloading(下载)、cropping(处理)、completed(完成)、failed(失败)。完成后状态含 expires(毫秒时间戳),视频仅保留 24 小时;到期下载返回 410,任务和积分记录保留。建议每 3–10 秒查询一次。
排队任务受理后,即使断开连接或服务重启也会继续。状态中的 creditsFrozen 表示实际冻结积分,optimization 表示优化阶段,详情中的 optimizedPrompt 提供已保存的优化结果。原始输入、最终提交与幂等键均持久化。任务未提交时可调用 POST /api/v1/videos/{id}/cancel 取消;已提交或结果未知时不能取消本地排队。
4. 使用参考素材(可选)
先获取空闲工作空间,使用返回的 uploadContext 上传二进制文件。上传返回 mediaId,将它加入生成请求的 media 数组。同一任务的所有素材必须在同一个工作空间上传,素材 ID 仅本人可用,有效期 24 小时;上传上下文有效期 1 小时。音色、动作等具体用途请在提示词中说明。
接口列表
| 方法 | 路径 | 功能 |
|---|---|---|
| GET | /api/v1/me | 当前账号、余额与每秒价格 |
| POST | /api/v1/videos | 创建视频任务 |
| GET | /api/v1/videos | 本人任务分页记录(page / pageSize) |
| GET | /api/v1/videos/{id} | 查询本人任务 |
| GET | /api/v1/videos/{id}/file | 下载本人视频(Bearer 鉴权) |
| GET | /api/v1/workspaces | 查询空闲工作空间(暂存素材无需先调用) |
| POST | /api/v1/media | 二进制素材暂存本站,单文件最多 100 MB,有效期24小时 |
列表接口默认每页 10 条:GET /api/v1/videos?page=1&pageSize=10,pageSize 最大 100。返回 jobs 和 pagination(page、pageSize、total、totalPages);超出总页数返回最后一页。
参考素材先通过 POST /api/v1/media 暂存本站,返回 mediaId、fileName 和 staged:true,不返回工作台绑定。无需先获取 workspaces 或传 X-Upload-Context;旧上传上下文被忽略,不会把素材锁到原工作台。将 mediaId 放入生成请求的 media 数组,服务端受理排队后,在空闲工作台分配及提示词检测通过后才向视频服务上传。暂存素材请求中的旧 workspaceId 不作为固定绑定;仅无暂存原件的历史云端素材仍绑定原台。受理后可关闭页面。每用户暂存上限1 GB,全站5 GB,单用户同时暂存1个文件。
常见错误
400:参数或幂等键冲突;401:Token 无效、已过期或已撤销;403:无权限;404:任务不存在或不属于你;402:积分不足或生成参数校验失败;409:暂无空闲工作空间、上传忙或素材上下文失效;410:视频已过期;413:请求过大;429:调用频率过高;502/503:服务暂不可用或提交待确认。API 默认持久排队,每10秒检查资源,最长1小时;queue=false 时无空闲返回409。排队和优化期间不冻结积分,提交前原子冻结;失败未提交不扣费。提交结果未知时保留冻结并核实原请求,不因排队超时盲目退款。新任务使用新键,未知结果重试沿用原键。
动作迁移 / 人物替换
所有请求(包括素材上传、查询和下载)使用 Authorization: Bearer YOUR_TOKEN,无需 Cookie 或 X-Frame-Request。创建任务还需 Idempotency-Key;费用从密钥所属账号的积分余额结算。
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /api/motion/config | 当前每次价格和素材限制 |
| POST | /api/v1/media | 逐个暂存图片和视频,返回各自的 mediaId |
| POST | /api/motion/tasks | 创建任务,返回 HTTP 202 和任务 ID |
| GET | /api/motion/tasks?page=1&pageSize=10 | 查询本人动作迁移及人物替换记录 |
| GET | /api/v1/videos/{id} | 查询进度;完成后用 /api/v1/videos/{id}/file 下载 |
上传使用文件二进制请求体及 URL 编码的 X-File-Name。需要一张 PNG/JPG/WEBP 人物图片和一段 4–30 秒 MP4/MOV 参考视频,单文件最多 100 MB。用同一账号获得两个素材 ID 后,提交 JSON:
{"imageId":"图片的 mediaId","videoId":"视频的 mediaId","operation":"transfer"}
transfer(默认)保留图片背景,迁移视频动作;replacement 保留视频背景,替换人物。价格以配置接口为准,按次计费;确认失败退回冻结积分,成片保留 24 小时。提交结果不明时沿用原幂等键和参数。
图片创作
OpenAI 兼容调用
Base URL:https://wzbotai.cn/v1。使用本站 Bearer 密钥,GET /v1/models 包含已开放的图片模型;POST /v1/images/generations 等待生成结果并返回 created、data[].b64_json 和扩展字段 task_id。默认及当前仅支持 response_format=b64_json,不支持 URL 返回或图片编辑端点。
{"model":"gpt-image-2.6","prompt":"黄昏下的城市街道","n":1,"size":"1024x1024","response_format":"b64_json"}模型名称以当前模型列表为准。可选 size=auto、1024x1024、2048x2048、4096x4096;横竖图使用本站扩展 aspect_ratio 与 resolution,和下方参数一致。quality 支持 auto/standard,其他质量档及 style 暂不支持。费用沿用图片创作定价。
建议每个新任务提供 Idempotency-Key。约100秒仍无结果时返回504及 error.task_id,任务继续处理、冻结保留;用下方异步查询接口查询,或原参数原幂等键重试。不要换键盲目重发。客户端超时同理;如需长时间生成,建议直接使用异步接口。
所有请求(包括原图下载)使用 Authorization: Bearer YOUR_TOKEN,无需 Cookie。创建任务还需 Idempotency-Key;费用从密钥所属账号的积分余额结算。
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /api/images/config | 启用状态与每张积分 |
| GET | /api/images/models | 查询管理员已开放的模型 |
| POST | /api/images/jobs | 创建任务并返回 HTTP 202 |
| GET | /api/images/jobs?page=1&pageSize=10 | 分页查询本人图片任务,pageSize 最大 50 |
| GET | /api/images/jobs/{id} | 查询状态、参数与结果;通过 images[].url 获取原图 |
| POST | /api/images/jobs/{id}/delete 或 /restore | 隐藏已结束的任务或恢复显示,不改变积分 |
请求示例(model 填模型列表返回的 ID):
{"model":"开放模型ID","prompt":"黄昏下的城市街道","n":1,"aspect_ratio":"1:1","resolution":"1k","images":[]}
n 为 1–9 张;比例支持 1:1、16:9、9:16、4:3、3:4;分辨率参数为 1k、2k、4k。images 可省略,传入时使用 PNG/JPEG/WEBP Base64 Data URL,最多 9 张;网页限制每张 10 MB、合计 22 MB,接口 JSON 上限 32 MB。按请求张数冻结积分,按实际交付张数结算。confirming 表示待核实,不要换幂等键重复提交。
用户管理
封禁后禁止登录及新任务,旧会话与API Token立即失效;解封不会恢复旧Token。已提交任务继续结算,账号、余额和历史保留。修改可用积分会单独记入使用明细。
| 账号 / 用户 ID | 角色 | 账号状态 | 注册时间 | 可用积分 | 冻结积分 | 任务数 | 操作 |
|---|
代理中心
只计算直接邀请用户的在线充值,按支付成功时的有效分润比例记账;兑换码和人工调账不参与。分润以人民币计算,四舍五入到分,不是可用积分。请联系管理员线下结算,本页面不会自动转账。
邀请用户
| 用户名 | 注册时间 | 在线充值金额 |
|---|
分润明细
| 时间 | 用户 | 充值订单 | 充值金额 | 当时比例 | 分润 | 状态 |
|---|
线下结算记录
| 结算时间 | 金额 | 操作管理员 | 备注 | 结算编号 |
|---|
代理管理
在“用户管理”中为普通用户设置代理及分润比例;暂停不删除邀请关系和历史分润。
| 账号 | 邀请码 | 比例 | 状态 | 邀请人数 | 待结算 | 累计分润 | 操作 |
|---|
代理明细
邀请用户
| 用户名 | 注册时间 | 在线充值金额 |
|---|
分润明细
| 时间 | 用户 | 充值订单 | 充值金额 | 当时比例 | 分润 | 状态 |
|---|
线下结算记录
| 结算时间 | 金额 | 操作管理员 | 备注 | 结算编号 |
|---|
代理设置记录
| 时间 | 操作管理员 | 比例 | 状态 |
|---|
后台概览
集中管理创作服务、运营内容与生成任务。
每项功能,各归其位。
选择下方分类开始管理。切换分类不会提交表单,也不会清空未保存的输入。
全部用户视频
兑换码使用记录
提示词安全检测
全站设置,仅影响之后新受理的任务;普通模型和备用模型同时生效。提示词优化开关独立,不会随此开关关闭。