开发者 · HTTP
已上船入口,不是虚构 REST
没有可下载的 SDK / OpenAPI / Postman。公开目录可匿名;写操作与 Studio 相同,走会话 Cookie。
01
Quick Start
GET /studio/models 可匿名。POST /studio/video 需要已登录会话,与工作台同一套 AuthGuard。
内容含 AI 生成 · 已通过合规审核本接口输出视频属于 AIGC,请遵守平台规范合法使用
公开模型目录cURL
# GET /studio/models — public catalog curl "$API_BASE/studio/models"
创建生成任务(需会话)cURL
# POST /studio/video — session cookie (same as Studio)
curl "$API_BASE/studio/video" \
-H "Cookie: authjs.session-token=…" \
-H "Content-Type: application/json" \
-d '{"type":"studio","params":{"prompt":"product demo"}}'02
已上船 Endpoints
下表 path 与 Nest @Controller 装饰器一致。仓库没有 OpenAPI 静态文件,因此不提供「查看 OpenAPI」按钮。
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| GET | /studio/models | 公开 | 已启用模型目录(modelId / displayName / providerKind) |
| POST | /studio/video | 会话 | 创建生成任务,按积分计费 |
| GET | /studio/video/:id | 会话 | 查询单条任务(无 org 时当不存在) |
| GET | /credits/catalog | 公开 | 可购积分包与 consumer 套餐(CNY 分 + credits) |
| POST | /newsletter/subscribe | 公开 | 订阅通讯,写入 newsletter_subscribers |
| GET | /health | 公开 | 进程健康检查(db / redis) |
| POST | /health/client-error | 公开 | 前端 error.tsx 上报,写入 client_errors |
| GET | /public/gallery | 公开 | 公开样片目录(场景模板,不含 prompt) |
写操作走 AuthGuard 会话。租户可创建 API key,但 Studio 生成面尚未挂 ApiKeyGuard。
03
配额说明
套餐按积分计费,见 GET /credits/catalog。限流是服务端全局桶,没有按套餐公布的每分钟配额,因此配额卡不填写虚构数字。
会话 HTTP
与 Studio 相同
生成与账单走登录会话。不要把未公布的套餐速率当成价目事实。
积分 catalog
CNY 分 + credits
价格与月度积分以 GET /credits/catalog 为准,可在账单页查看。
04
客户端
没有公开发布的 Node / Python / Go SDK,也没有 Postman Collection 或 OpenAPI 静态文件。请直接调用上表 HTTP。
cURL 示例见 Quick Start。应用内客户端是仓库私有包,未发布到 npm。
开始调用
在 Studio 里用同一套 HTTP 生成 →