platform.ciyuanfun.cn

API 分类

🔍 健康检查 📋 OIDC 发现 🎨 MaM 素材库 📦 SDK 示例

服务概览

🔐 认证鉴权

用户注册/登录、OAuth 2.0、OIDC、SSO 单点登录

7 个端点

🎤 声音克隆 & TTS

阿里云百炼声音复刻、语音合成、音色库管理

9 个端点

🖼️ AI 图片生成

Seedream 文生图、素材库管理、模型定价

4 个端点

🎬 视频生成

火山方舟 Seedance 文生视频、异步轮询、失败自动退款

3 个端点

📖 故事 & 分镜

故事管理、分镜编辑、自动视频生成 + 配音合成

14 个端点

👤 角色 & 素材

角色、场景、道具的增删改查

8 个端点

🔐 统一认证 & 渠道商

admin.ciyuanfun.cn 管理端、渠道商体系、用户管理

14 个端点

💳 套餐 & 支付

套餐选购、微信支付下单、订单查询

4 个端点

💰 钱包 & 积分

用户钱包充值（微信支付扫码）、余额查询、积分收入明细、PX 双向兑换

7 个端点

🔁 PX 积分兑换

通用积分兑换枢纽：三模式路由（api/gateway/none）+ 积分包购买 + 汇率校准 + 消费进度

5 个端点

🔐 认证鉴权

POST

注册

/api/v1/auth/register
创建新用户账号
POST

登录

/api/v1/auth/login
用户密码登录，返回 Token Pair
POST

刷新 Token

/api/v1/auth/refresh
用 Refresh Token 刷新 Access Token
GET

用户信息

/api/v1/users/profile
获取当前登录用户信息（需 Bearer Token）
POST

登出

/api/v1/users/logout
登出并撤销当前 Token
GET

授权

/oauth/authorize
OAuth 2.0 授权码流程
POST

Token 端点

/oauth/token
获取/刷新 OAuth Token
GET

JWKS

/api/v1/.well-known/jwks.json
JWT 公钥集

🎤 声音克隆 & TTS

POST

声音复刻

/api/v1/org/voices/clone
上传音频克隆声音（阿里云百炼 qwen-voice-enrollment）
POST

上传音频

/api/v1/org/voices/upload
上传 WAV/MP3 音频素材，≤10MB
GET

音色列表

/api/v1/org/voices
列出我的音色库
POST

创建音色

/api/v1/org/voices
创建音色记录
PUT

更新音色

/api/v1/org/voices/:id
更新音色信息
DEL

删除音色

/api/v1/org/voices/:id
删除音色
POST

TTS 合成

/api/v1/org/tts/synthesize
文本转语音（阿里云百炼 qwen3-tts-vc）
GET

可用音色

/api/v1/org/tts/voices
所有已克隆可用于合成的音色
GET

音频文件

/api/v1/org/voices/file/:filename
获取上传的音频文件（支持 Range）

🖼️ AI 图片生成

POST

文生图

/api/v1/org/generate/image
Seedream 直连文生图（4.0/4.5/5.0-lite），同步返回，扣积分+失败自动退款
GET

素材列表

/api/v1/org/assets
素材库分页列表（page/size）
GET

素材文件

/api/v1/org/assets/file/:id
素材图片文件服务
GET

模型定价

/api/v1/org/pricing/image-models
图片模型档位与积分定价

🎬 视频生成

POST

创建视频任务

/api/v1/org/videos
文生视频（Seedance 2.0/2.0-fast/2.0-mini，时长 2-12 秒，选几秒出几秒，失败自动退款）
GET

视频列表

/api/v1/org/videos
列出我的视频生成任务（queued/running/succeeded/failed）
DEL

删除视频

/api/v1/org/videos/:id
删除视频记录

📖 故事 & 分镜

POST

创建故事

/api/v1/org/stories
创建故事，自动解析剧本为分镜
GET

故事列表

/api/v1/org/stories
用户故事列表
GET

故事详情

/api/v1/org/stories/:id
故事完整详情（含分镜）
PUT

更新分镜

/api/v1/org/stories/:id/panels/:pid
更新单分镜内容
POST

新增分镜

/api/v1/org/stories/:id/panels
新增空白分镜，支持 ?after=N 插入
DEL

删除分镜

/api/v1/org/stories/:id/panels/:pid
删除分镜并重排编号
PUT

重排分镜

/api/v1/org/stories/:id/panels/reorder
按 panel_ids 数组重排顺序
GET

生成视频

/api/v1/org/stories/:id/video
异步提交分镜到 Seedance 生成视频
GET

视频状态

/api/v1/org/stories/:id/video/status
查询视频生成状态（分镜级进度）
GET

拼接视频

/api/v1/org/stories/:id/video/concat
🎬 分镜拼接(本地合并，不耗 Seedance token)
GET

故事配音

/api/v1/org/stories/:id/tts
生成整故事配音音频
GET

配音状态

/api/v1/org/stories/:id/audio
查询故事配音音频
POST

混音

/api/v1/org/stories/:id/audio/mix
配音混入故事视频
POST

上传分镜视频

/api/v1/org/stories/:id/panels/:no/upload
上传自定义分镜视频

👤 角色 & 素材

GET

角色列表

/api/v1/org/characters
我的角色库
POST

创建角色

/api/v1/org/characters
创建角色（支持 gen_mode/gen_ratio）
PUT

更新角色

/api/v1/org/characters/:id
动态更新角色字段
DEL

删除角色

/api/v1/org/characters/:id
删除角色记录
GET

场景列表

/api/v1/org/stories/:id/scenes
故事下的场景列表
POST

创建场景

/api/v1/org/stories/:id/scenes
创建场景（默认 text2img）
GET

道具列表

/api/v1/org/stories/:id/props
故事下的道具列表
POST

创建道具

/api/v1/org/stories/:id/props
创建道具

🔐 统一认证 & 渠道商

🔐 admin.ciyuanfun.cn 管理端 📋 接口文档

管理端入口

🔐 管理端入口

admin.ciyuanfun.cn

统一认证生态管理入口：302 → login.html（超管/渠道商双 tab）→ 超管 index.html / 渠道商 reseller-panel.html
POST

管理端登录

/admin/login
超管/渠道商 bcrypt+JWT 登录，返回 role/token
GET

当前管理账号

/admin/me
当前管理员信息（Bearer JWT / X-Mam-Admin-Key）
GET

渠道商统计

/admin/reseller/me/stats
渠道商自助统计（用户数/消耗）
POST

补贴积分

/admin/reseller/me/credits
渠道商给名下用户补贴积分（校验归属+余额）
POST

邀请码

/admin/reseller/me/invite
渠道商生成/重置邀请码（/invite/regenerate）

💳 套餐 & 支付

GET

套餐列表

/api/v1/org/packages/plans
免费版 / 入门版 / 标准版 / 专业版
GET

已购套餐

/api/v1/org/packages
查询已购买的套餐
POST

购买套餐

/api/v1/org/packages/buy
免费直接激活 / 付费生成微信支付订单
GET

订单查询

/api/v1/org/packages/order
查询订单支付状态

💰 钱包 & 积分

GET

充值套餐 & 汇率

/api/v1/wallet/recharge/plans
获取充值套餐列表与人民币:积分汇率（默认 1 元 = 1 积分）
POST

微信充值下单

/api/v1/wallet/recharge
创建微信支付 Native 订单，返回二维码 URL、订单号与到账积分
GET

充值订单状态

/api/v1/wallet/recharge/status
轮询支付状态（paid / SUCCESS / CLOSED / PAYERROR 等）
GET

钱包余额

/api/v1/wallet/balance
查询当前用户积分余额
GET

账户明细

/api/v1/wallet/account/income
积分收入明细，按「充值 / 平台转入 / 其他转入」分类
GET

PX 余额

/api/v1/wallet/px/balance
PX 积分余额（账本口径，与 PX 平台一致）
POST

PX 双向兑换

/api/v1/wallet/px/exchange
Mam ↔ PX 兑换（px_to_mam=消费无手续费 / mam_to_px=退款 1% 手续费进资金池）

🔁 PX 积分兑换枢纽

GET

兑换对象列表

/api/exchange/partners
18 个可兑换积分种类（MaM 已启用 rate 1:1；6 大模型伙伴支持 gateway 积分包）
POST

兑换执行

/api/exchange/redeem
三模式路由：api=伙伴直连入账 / gateway=购买积分包(scenarioId) / none=暂未接入；consume 兑换无费、refund 退款 99% 到账；支持 targetUsername 跨用户互换
GET

账本余额查询

/api/users/ledger-balance
按链上地址查 users_backend.json 账本余额（运营真相源，公开）
GET

消费进度

/api/gateway/credits/{username}
综合 MaM 兑换 + gateway 托管积分（已获得/可用/已消费），移动端进度条数据源
GET

交易记录

/api/transactions?username=
用户交易记录（exchange 记录带 direction/toName/partnerName 语义）

⚙️ 开发者控制台

GET

应用列表

/api/v1/org/apps
我的开发者应用
POST

创建应用

/api/v1/org/apps
注册新应用获取 AppKey
GET

调用日志

/api/v1/org/logs
API 调用记录
GET

服务健康

/health
服务健康检查
GET

OIDC 发现

/.well-known/openid-configuration
OpenID Connect 发现文档