API 文档

👤 用户模块

7 接口

POST /api/user/login

微信小程序登录，获取用户信息和Token

请求参数

参数名	类型	必填	说明
code	string	必填	微信登录code
encryptedData	string	可选	加密用户信息
iv	string	可选	加密向量

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "user": { "id": 1, "nickname": "xxx", ... },
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user_plan": { ... }
  }
}

POST /api/user/verify_token

验证Token有效性

请求头

参数名	类型	必填	说明
Authorization	string	必填	Bearer Token

GET /api/user/info 需登录

获取当前用户信息

POST /api/user/bind_phone 需登录

绑定手机号（支持微信解密或直接传入）

请求参数

参数名	类型	必填	说明
code	string	可选	手机号加密code
encryptedData	string	可选	加密手机号数据
iv	string	可选	加密向量
phone	string	可选	直接传入手机号（二选一）

POST /api/user/bind_phone_by_code 需登录

通过微信解密绑定手机号

POST /api/user/update 需登录

更新用户信息

请求参数

参数名	类型	必填	说明
nickname	string	可选	昵称
gender	int	可选	性别
birthday	string	可选	生日 YYYY-MM-DD
real_name	string	可选	真实姓名

POST /api/user/upload_avatar 需登录

上传头像

📁 文件模块

6 接口

POST /api/file/upload 需登录

上传文件到七牛云（支持 multipart/form-data 或 raw binary）

请求头

参数名	类型	必填	说明
X-Filename	string	可选	文件名（raw模式）

POST /api/file/upload_save 需登录

保存文件到本地服务器

POST /api/file/upload_from_url 需登录

从URL下载并保存文件

请求参数

参数名	类型	必填	说明
videoUrl	string	必填	视频URL
filename	string	可选	自定义文件名

GET /api/file/list 需登录

获取用户文件列表

请求参数

参数名	类型	必填	说明
page	int	可选	页码，默认1
page_size	int	可选	每页数量，默认10

GET /api/file/get/{filename} 需登录

获取文件内容

POST /api/file/delete 需登录

删除文件

💬 聊天模块

7 接口

GET /api/chat/conversations 需登录

获取对话列表

GET /api/chat/conversations/{id} 需登录

获取单个对话详情

POST /api/chat/conversations 需登录

创建新对话

POST /api/chat/conversations/delete 需登录

删除对话

POST /api/chat/send 需登录

发送消息（流式响应）

请求参数

参数名	类型	必填	说明
content	string	必填	消息内容
conversation_id	int	可选	对话ID
model	string	可选	模型名称
instruction_set_id	int	可选	指令集ID

POST /api/chat/stream 需登录

流式消息接口（直接中转）

POST /api/chat/v1/chat/completions 需登录

OpenAI 兼容接口（流式）

📋 指令集模块

6 接口

GET /api/instruction_sets 需登录

获取指令集列表（自己创建的 + 公开的）

请求参数

参数名	类型	必填	说明
page	int	可选	页码
page_size	int	可选	每页数量
status	int	可选	状态筛选
is_public	bool	可选	是否公开
type	string	可选	创作类型筛选：文案创作、音乐创作、图片创作、视频创作
tag	string	可选	标签筛选

GET /api/instruction_sets/public

获取公开指令集（无需登录）

请求参数

参数名	类型	必填	说明
page	int	可选	页码，默认1
page_size	int	可选	每页数量，默认20
type	string	可选	创作类型筛选：文案创作、音乐创作、图片创作、视频创作
tag	string	可选	标签筛选

POST /api/instruction_sets/detail

获取指令集详情

请求参数

参数名	类型	必填	说明
set_id	int	必填	指令集ID

POST /api/instruction_sets/create 需登录

创建指令集（需绑定手机号）

请求参数

参数名	类型	必填	说明
name	string	必填	名称
content	string	必填	内容；兼容 instructions
type	string	可选	创作类型，默认文案创作；可选：文案创作、音乐创作、图片创作、视频创作
status	int	可选	状态，默认1
is_public	bool	可选	是否公开
tags	array	可选	标签列表
icon	string	可选	图标URL

POST /api/instruction_sets/update 需登录

更新指令集

请求参数

参数名	类型	必填	说明
id / setId / instruction_set_id	int	必填	指令集ID
name	string	可选	名称
content	string	可选	内容；兼容 instructions
type	string	可选	创作类型：文案创作、音乐创作、图片创作、视频创作
status	int	可选	状态
is_public	bool	可选	是否公开
tags	array/string	可选	标签列表或逗号分隔字符串
icon	string	可选	图标URL

POST /api/instruction_sets/delete 需登录

删除指令集

请求参数

参数名	类型	必填	说明
set_id	int	必填	指令集ID

🤖 AI数字人模块

2 接口

POST /api/aihuman/train 需登录

训练AI数字人（消耗数字人资源）

请求参数

参数名	类型	必填	说明
video_url	string	必填	训练视频URL
auth_video_url	string	必填	授权视频URL
custom_tag	string	可选	自定义标签

POST /api/aihuman/video/generate 需登录

生成数字人视频（消耗视频资源）

请求参数

参数名	类型	必填	说明
title	string	必填	视频标题
content	string	必填	口播内容
aihumanId	string	必填	数字人ID
voiceId	string	必填	声音ID
clipTemplate	string	可选	剪辑模板
coverplate	string	可选	封面模板

🎙️ AI语音模块

2 接口

POST /api/ai-voice/train 需登录

训练AI声音（消耗声音资源）

请求参数

参数名	类型	必填	说明
audio_url	string	必填	训练音频URL
custom_tag	string	可选	自定义标签

GET /api/ai-voice/list 需登录

获取用户声音列表

🎬 视频混剪模块

5 接口

POST /api/video-mix/create 需登录

创建视频混剪任务

GET /api/video-mix/list 需登录

获取视频混剪任务列表

GET /api/video-mix/detail/{task_id} 需登录

获取任务详情；兼容 /api/video-mix/detail?id={task_id}

POST /api/video-mix/sync/{task_id} 需登录

同步任务状态

💳 支付模块

5 接口

POST /api/pay/create_order 需登录

创建订单

请求参数

参数名	类型	必填	说明
total_amount	float	必填	订单金额
body	string	可选	商品描述

POST /api/pay/prepay 需登录

获取微信支付参数

POST /api/pay/notify

支付回调（微信服务器调用）

GET /api/pay/query 需登录

查询订单状态

POST /api/pay/refund 需登录

申请退款

⚡ 闪剪任务模块

4 接口

POST /api/shanjian/sync

同步所有闪剪任务状态

GET /api/shanjian/list

获取闪剪任务列表

GET /api/shanjian/video-templates

获取视频模板列表（支持分页和搜索）

请求参数

参数名	类型	必填	说明
pageSize	int	可选	每页大小，默认10
sid	string	可选	分页游标
scene	string	可选	场景类型
searchKey	string	可选	搜索字段(name/id)
searchValue	string	可选	搜索值
sortBy	string	可选	排序方式(desc/asc)

GET /api/shanjian/cover-templates

获取封面模板列表（支持分页和搜索）

POST /api/shanjian/callback

闪剪任务回调 WEBHOOK，提供给闪剪： https://yixiuapi.xyaip.fun/api/shanjian/callback

请求参数

参数名	类型	必填	说明
taskId	string	必填	闪剪任务ID
status	string	必填	processing/succeed/failed
result	object	可选	任务结果，如 videoUrl、coverUrl、audioUrl、imageUrl 等
errorCode	string	可选	失败错误码
errorMessage	string	可选	失败错误描述

📦 素材模块

6 接口

POST /api/material/add 需登录

添加素材

GET /api/material/list 需登录

获取素材列表

POST /api/material/music/add 需登录

添加音乐素材

GET /api/material/music/list 需登录

获取音乐列表

POST /api/material/kongjing/add 需登录

添加空镜素材

GET /api/material/kongjing/list 需登录

获取空镜列表

🔥 热点列表模块

2 接口

GET/POST /api/hotlist/search

搜索热点，返回 query、summary 和 items（无需登录）

固定使用 REALTIME 模式，只返回当前实时热点

仅返回：抖音、B站、微博、百度文娱、头条新闻、腾讯新闻、纽约时报、BBC、法广、澎湃新闻

请求参数

参数名	类型	必填	说明
keywords	string[]/string	可选	实时热点关键词，为空时返回全部指定来源热点
rootCategories/categories	string[]/string	可选	根分类过滤
limit	int/null	可选	数量限制，默认50
offset	int	可选	结果偏移量，默认0
distinct	bool	可选	是否按标题去重

GET /api/hotlist/list

保持原有行为，调用旧版接口并原样返回 items（无需登录）

请求参数

参数名	类型	必填	说明
categories	string	可选	分类，默认all
keywords	string	可选	关键词筛选
limit	int	可选	数量限制，默认50

☁️ 七牛云模块

2 接口

GET /api/qiniu/upload-token 需登录

获取七牛云上传Token

POST /api/qiniu/upload-to-qiniu 需登录

从URL上传到七牛云

📝 脚本模块

6 接口

POST /api/script/create 需登录

创建脚本

GET /api/script/list 需登录

获取脚本列表

GET /api/script/{script_id} 需登录

获取脚本详情

POST /api/script/update/{script_id} 需登录

更新脚本

POST /api/script/delete 需登录

删除脚本

GET /api/script/video/next 需登录

获取下一个待发布的视频

🔧 Prompt模块

6 接口

GET /api/prompt/prompts 需登录

获取Prompt列表（自己的 + 默认的）

GET /api/prompt/prompts/{id} 需登录

获取单个Prompt

POST /api/prompt/prompts 需登录

创建Prompt

POST /api/prompt/prompts/update 需登录

更新Prompt

POST /api/prompt/prompts/delete 需登录

删除Prompt

POST /api/prompt/prompts/default 需登录

设置默认Prompt

🎥 视频模块

6 接口

POST /api/video/production/create 需登录

创建视频制作任务

GET /api/video/production/list 需登录

获取视频制作任务列表

GET /api/video/production/{task_id} 需登录

获取任务详情

POST /api/video/production/update-result 需登录

更新任务结果

GET /api/video/production/teams 受限接口

获取团队主账户、主账户 ID 和视频剩余权益。仅 user_id=1 且 team_phone=15921964590 可调用。

请求参数

参数名	类型	必填	说明
page	int	可选	页码，默认 1
page_size	int	可选	每页数量，默认 50，最大 100
keyword	string	可选	搜索手机号、昵称或真实姓名

POST /api/video/production/assign-team 受限接口

将已完成视频分配给指定团队主账户，并扣减目标团队 1 个视频权益。仅 user_id=1 且 team_phone=15921964590 可调用。

请求参数

参数名	类型	必填	说明
videoId	int	必填	已完成视频 ID
targetTeamPhone	string	必填	目标团队手机号
targetMainUserId	int	必填	目标团队主账户用户 ID

📦 套餐模块

6 接口

GET /api/plan/list 需登录

获取套餐列表

POST /api/plan/purchase 需登录

购买套餐

GET /api/plan/user-plan 需登录

获取用户套餐信息

POST /api/plan/deduct 需登录

扣除资源

GET /api/plan/purchase-history 需登录

获取购买历史

POST /api/plan/init-plans

初始化套餐（管理员）

📤 上传模块

3 接口

POST /api/upload/material 需登录

上传素材到七牛云

POST /api/upload/images 需登录

批量上传图片

POST /api/upload/videos 需登录

批量上传视频

👥 账号模块

5 接口

GET /api/account/list 需登录

获取用户账号列表

GET /api/account/valid 需登录

获取有效账号列表

POST /api/account/add 需登录

添加账号

POST /api/account/update 需登录

更新账号

POST /api/account/delete 需登录

删除账号

⭐ 积分模块

4 接口

POST /api/points/add 需登录

增加积分

POST /api/points/deduct 需登录

扣除积分

GET /api/points/balance 需登录

获取积分余额

GET /api/points/records 需登录

获取积分记录