文档中心

一个入口看清 mind2video 的核心运行方式

这页集中说明 mind2video 如何处理生成、积分、回调、存储,以及最关键的公开接口。

平台概览

生成、积分、支付、回调与对象存储已经串成完整链路。

模型Sora / Veo / Seedance / Wan
积分流程freeze / settle / release
交付callback + R2

生成

文生视频、图生视频和参考视频共用一套生成器体验。

积分

freeze / settle / release 保持一致,避免计费漂移。

回调

Provider 回调完成任务后,会把结果转存到 R2 或兼容 S3 的存储。

快速开始

从账号登录、积分购买、模型选择到任务追踪,这里给你最短路径。

1

创建账号

支持 Google OAuth 和 Magic Link,登录后直接进入工作区。

2

购买积分或开通套餐

Creem 是主支付通道,Stripe 作为备选支付通道保留。

3

选择模型并提交

可使用 Sora 2、Veo 3.1、Seedance 1.5 或 Wan 2.6。

4

跟踪任务直至完成

提交时先冻结积分,成功结算,失败释放。

生成流程

下面的流程与当前项目里的实际服务流程保持一致。

请求进入 /api/v1/video/generate,创建视频记录并选择模型。

在提交 Provider 之前先冻结积分。

Provider 异步执行任务,并通过回调接口回传状态。

系统拉取结果后上传到 R2 或其他兼容 S3 的对象存储。

任务成功时 settle,失败时 release。

流程快照

generate() -> freeze credits -> provider task -> callback -> upload -> settle/release

generate()
  -> create video row
  -> freeze credits
  -> submit provider task

callback(provider)
  -> download result
  -> upload to object storage
  -> settle() or release()

核心接口

这里只保留最关键的 API 入口,方便快速理解系统接入面。

方法路径说明
POST
/api/v1/video/generate

创建生成任务并冻结积分

GET
/api/v1/video/list

获取用户的视频列表

GET
/api/v1/config/models

读取可用模型配置

POST
/api/v1/video/callback/[provider]

接收 Provider 回调

常见问题

文档入口已经可用

站点导航和其他页面现在都可以直接指向这里,不会再落到缺失路由。

文档 | mind2video