API v1.0.0 · PX兑换枢纽 · 统一身份认证 · 语音合成 · 图片/视频生成 · 渠道商管理 · ← 返回首页
所有 API 通过 HTTPS 访问，认证方式：Bearer Token（用户API）或 HMAC-SHA256 签名（开放平台 API）。
# Bearer Token 示例 curl -H "Authorization: Bearer <token>" \ https://platform.ciyuanfun.cn/api/v1/org/stories # HMAC-SHA256 签名（开放平台 /open/v1/*） # 参见下方"签名算法"
{"username","password","display_name"}curl -X POST https://platform.ciyuanfun.cn/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"username":"test","password":"123456","display_name":"测试"}'{"username","password"}curl -X POST https://platform.ciyuanfun.cn/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"test","password":"123456"}'curl -X POST https://platform.ciyuanfun.cn/api/v1/org/voices/clone \ -H "Authorization: Bearer <token>" \ -F "audio=@sample.wav" \ -F "name=my_voice"
qwen3-tts-vc-2026-01-22curl -X POST https://platform.ciyuanfun.cn/api/v1/org/tts/synthesize \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"text":"你好世界","voice_id":"xxx"}'{"prompt","model","quality","size"}seedream-4.0（标准/3分）、seedream-4.5（2K/4K/4分）、seedream-5.0-lite（2K/3K/4K/4分）、qwen-image（2K/3K/4K/4分，阿里百炼）；size 支持 1:1/4:3/3:4/16:9/9:16/3:2/2:3。返回 asset_id + 图片 URL；生成或保存失败自动退款。curl -X POST https://platform.ciyuanfun.cn/api/v1/org/generate/image \
-H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
-d '{"prompt":"海边日落","model":"seedream-4.5","quality":"2K","size":"16:9"}'page/size；返回 data 素材数组（id/name/asset_type/image_url 等），图片经 /org/assets/file/:id 访问。seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini（火山方舟，支持文生/多图参考/首尾帧）、happyhorse（阿里百炼，仅多图参考）；mode: text2video文生视频（默认）/ multi_ref多图参考 / first_last_frame首尾帧；resolution 480p/720p/1080p；时长: duration 2-12 秒整数（选几秒出几秒）；比例: ratio 16:9/9:16/1:1/4:3/3:4/21:9/adaptive（HappyHorse 仅固定比例，adaptive 自动转 16:9）。ref_images（公网 HTTP 图片 URL：多图参考 1-9 张；首尾帧第 1 张=首帧必填、第 2 张=尾帧可选；如素材库 /api/v1/org/assets/file/:id）。queued排队 / running生成中 / succeeded完成 / failed失败（含原因）curl -X POST https://platform.ciyuanfun.cn/api/v1/org/videos \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"prompt":"海浪拍打礁石","model":"seedance-2.0-mini","resolution":"480p","duration":4,"ratio":"16:9"}'"角色名"对白内容 自动拆分为分镜curl -X POST https://platform.ciyuanfun.cn/api/v1/org/stories \
-H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
-d '{"title":"新故事","script":"场景1描述...\\n\\"我\\"这是我的对白"}'duration(自动/5/10/15)、ratio(16:9/9:16/1:1)curl "https://platform.ciyuanfun.cn/api/v1/org/stories/17/video?duration=auto&ratio=16:9&resolution=720p" \ -H "Authorization: Bearer <token>"
panel_nos(逗号分隔的分镜序号，控制拼接顺序，如 4,3,2,1 倒序；缺省按序号升序)curl "https://platform.ciyuanfun.cn/api/v1/org/stories/22/video/concat?panel_nos=1,2,3,4" \ -H "Authorization: Bearer <token>"
date_from/date_to（YYYY-MM-DD，默认近 14 天，区间 ≤366 天）；返回每日 credits_consumed 列表与 total_consumed。渠道商只看自己名下用户。{"user_id":68,"amount":10}；校验用户归属，余额不足拒绝。page/page_size/keyword/status/reseller_id；超管可按 reseller_id 筛选（0=none 未绑定），渠道商强制只看自己名下。返回含 credits 余额与 reseller_name。{"phone":"13900000000","password":"123456","username":"可选","email":"可选","reseller_id":"超管可选"}；自动生成钱包；渠道商创建自动归属自己。{"amount":100,"description":"活动赠送"}；amount 为正加负扣，写 admin_adjust 流水（不计入消耗统计）。{"users":[{"phone":"13900000001","password":"123456","username":"可选","email":"可选"}]}；返回 success_count/fail_list。{"name","enabled":0|1,"qualities":[...],"sizes":["1:1","16:9",...],"factory_cost","published_price"}；enabled=0 停用后用户端不再显示该模型，sizes 控制生图尺寸选项。{"name","enabled":0|1,"credits_rule":{"720p":15},"sizes":[...],"modes":["text2video","multi_ref","first_last_frame"],"durations":[4..12],"factory_cost","published_price"}；modes 控制该模型在视频工坊可选模式，sizes/durations 控制尺寸与时长选项，enabled 控制启用/停用。以上字段均支持独立提交（快捷启用/禁用按钮只传 enabled）。统一认证生态（MaM + PX + 各合作平台）的管理入口。渠道商体系 2026-08-16 落地：admin.ciyuanfun.cn（root=/www/wwwroot/mam-admin）→ 302 → login.html（双 tab：🏢超管 / 🔑渠道商）→ 超管跳 index.html、渠道商跳 reseller-panel.html（独立控制台）。账号存 id_auth.cy_admins（role=super|reseller），创建/改密/删除渠道商自动同步该表。nginx 对 login/reseller-panel 加 no-cache 头。
{"username","password"}。bcrypt 校验 + JWT，返回 role（super/reseller）、token、name。超管初始账号 admin/Admin@2026!。渠道商登录后仅可访问 /admin/reseller/me* 与 /admin/users*，其余 403。X-Mam-Admin-Key（超管）。ref_type='admin_adjust'）。ref_type='px_exchange' 或 ref_type='admin_adjust' 且描述含"PX兑换"、amount>0），排除现金充值。供 PX 端消费进度（/api/gateway/credits/{username}）调用。返回 {"success":true,"user_id":5,"px_exchange_total":2}。鉴权：X-Mam-Admin-Key。{"user_id":N,"amount":N,"description":"可选"}；校验用户归属自己名下 + 渠道商积分池余额充足，不足拒绝。{"old_password","new_password"}；校验旧密码，双写 cy_admins/cy_resellers。rate（默认 1 元=1 积分）。curl https://platform.ciyuanfun.cn/api/v1/wallet/recharge/plans \ -H "Authorization: Bearer <token>"
plan_id（选套餐）或 amount_fen（自定义金额，单位分）。返回 out_trade_no、code_url（二维码内容）、credits。用 code_url 生成二维码供用户扫码。curl -X POST https://platform.ciyuanfun.cn/api/v1/wallet/recharge \
-H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
-d '{"plan_id":1}'out_trade_no。返回 data.status：paid/SUCCESS=已支付，CLOSED/PAYERROR/REVOKED=失败。前端据此弹成功/失败框。curl "https://platform.ciyuanfun.cn/api/v1/wallet/recharge/status?out_trade_no=RCGxxxx" \ -H "Authorization: Bearer <token>"
balance。curl https://platform.ciyuanfun.cn/api/v1/wallet/balance \ -H "Authorization: Bearer <token>"
way_text 分为「充值 / 平台转入 / 其他转入」，含积分数值与获得时间（前端不展示人民币）。curl https://platform.ciyuanfun.cn/api/v1/wallet/account/income \ -H "Authorization: Bearer <token>"
money（充值记录：金额/到账积分/退款状态 + 充值总额/已退/可退，人民币）与 credits（当前积分余额 + 全量流水：充值/消费/退款扣回/赠送等，含余额快照）。充值页「账户详情」数据源。{"direction":"mam_to_px"|"px_to_mam","amount":N}。规则：① 双向 ② 比例 1:1（PX 1 = 人民币 1 元 = Mam 1 积分）③ 手续费 1% 以 Mam 计价，最低 1 Mam（mam_to_px 扣 amount+手续费；px_to_mam 到账 amount-手续费）④ 不做提现。底层走 PX 平台转账（平台 PX 资金池地址=market_config.platform_px_address），本地写 px_exchange 流水，转账失败自动回滚。refundable、refund_fen（可退金额/分）、refund_credits（扣回积分）、reason（不可退原因）。规则：仅已支付且未退款订单；无消费全额退；有消费扣除净消费额 15%；消费占比 ≥85% 不予退款。{"reason":"退款原因"}（必填）。微信受理成功后事务内扣回积分并写流水（type='recharge_refund'）；订单进入 refunding，由 60s 定时器查询微信退款单最终状态：SUCCESS→refunded，异常→自动回加积分+failed（可重试）。每单仅退一次。PX 作为统一认证生态的积分兑换枢纽/清算所：兑换（px→积分）=消费语义、无手续费；退款（积分→px）=退给自己、99% 到账、1% 手续费进 owner 资金池；支持 targetUsername 跨用户互换（对方付积分、你付 PX）。数据真相源为 users_backend.json 账本。2026-08-26 三模式路由：① api=伙伴端真实入账（MaM，调伙伴 API 真实发放积分）；② gateway=平台内托管积分包（DeepSeek/文心/通义/智谱/hy3/Kimi 共 6 个大模型伙伴，scenarios 选包 → 扣 PX → 写入 gateway 托管积分 → 可在 AI 网关 /api/gateway/chat 消费）；③ none=暂未接入（银行/电信/南航/麦当劳/莱美等生活积分，仅登记、暂不真实发放）。汇率口径：rate = 1 PX 兑换的目标平台 credit 数量（如 DeepSeek 1PX→30万 DS Credits、电信 1PX→100 积分）；模式 C 按真实官方比例校准（中行500/电信100/南航10/麦当劳10/莱美10）。移动端"消费进度"综合 MaM 兑换 + gateway 托管积分（已获得/可用/已消费）。
id=18 已启用（rate=1.0，apiEndpoint=MaM 管理积分接口 + apiKey）。6 个大模型伙伴恢复 apiKey 并支持 gateway 积分包：DeepSeek(id=1)/文心(id=2)/通义(id=3)/智谱(id=5)/Tencent-hy3(id=15)/Kimi(id=17)，scenarios 字段含可选积分包（如 ds_free: 1PX→30万 DS Credits、hy_standard: 5PX→500万 hy_credits）。{"username":"发起方","partnerId":N,"amount":N,"direction":"consume"|"refund","scenarioId":"ds_free"(仅 gateway),"targetUsername":"目标用户"}。api（配 apiEndpoint，如 MaM）：跨用户时查目标方积分余额（不足拒「目标用户积分不足」）→ 扣目标方积分 → 发起方得积分 → PX 双向过户 → 记 exchange(consume)；② gateway（有 scenarios 包，如 DeepSeek/hy3/Kimi）：校验 PX 余额 ≥ 包 pxCost → 扣 PX → GatewayController.addCredits 写入该用户平台托管积分 → 记 exchange(direction=buy, scenarioId, credits)（失败回滚 PX）；2026-09-05 起支持任意数量购买：不传 scenarioId 时按 amount × rate 折算入账（quota=floor(amount×rate)），前端"兑换数量（px）"模式；传积分包仍要求 amount 恰等于包价；③ none：返回「该积分类型暂未接入」。refund 仅 api 模式支持。curl -X POST .../api/exchange/redeem -d '{"username":"花猫妹妹","partnerId":18,"amount":5,"direction":"consume","targetUsername":"oldworker"}' 示例-买 DeepSeek 包：curl -X POST .../api/exchange/redeem -d '{"username":"王五","partnerId":1,"amount":1,"direction":"consume","scenarioId":"ds_free"}'{"success":true,"username":"王五","balance":989}。账本（users_backend.json）是运营真相源；链上余额（/api/point/balance/{addr}）另作补真账轮次。PX 前端 points.js 与 MaM 端 PXBalance 均以此接口为显示口径。/api/v1/admin/users/{id}/px-exchange-total 返回已兑换 Mam 积分（usedCredits）；② gateway 伙伴：读平台托管积分（gateway_allocations.json）返回 totalCredits/usedCredits/可用。返回示例：{"success":true,"username":"王五","partners":[{"partnerName":"MaM AI 漫剧","creditUnit":"Mam","rate":1.0,"usedCredits":146},{"partnerName":"DeepSeek","creditUnit":"DS Credits","rate":300000,"totalCredits":300000,"usedCredits":0}]}。移动端"消费进度"卡片数据源。direction（consume/refund）、fromUsername（发起方）、toName（目标用户）、partnerName（积分平台名）、amount（源数量）、credits（到账/获得）、rate、fee（仅退款）。入口名 alias → 上游模型 1 PX 应得 备注 DS ds → deepseek-v4-flash 13 万 套餐 ds_free(1PX)/ds_standard(5PX) WenXin wenxin/ernie → ernie-4.5-turbo-128k 38 万 千帆 v2；输出上限 cap→12288；⚠️欠费停服(9/5 起勿测) TongYi al/qwen → qwen-plus 58 万 al_free(1PX) ZhiPu gl/glm → glm-5 7 万 glm_free(1PX)；推理模型小 max_tokens 时 content 空属正常 Kimi km/kimi → kimi-k2.6 4.5 万 org RPM=3 限流；moonshot-v1-8k 等已下线 Tencent hy（直连 hy3 preview） 6.6 万 hy_standard(5PX)/hy_pro(10PX) 兑换执行：gateway 积分包(带 scenarioId) 或 任意数量(不带 scenarioId → amount×rate，9/5 起) 鉴权：POST /api/gateway/allocations 需 X-Admin-Token（9/5 堵白嫖）；用户购买一律走 /api/exchange/redeem 真扣 PX
开放平台 API 使用 HMAC-SHA256 签名，详见签名算法 Tab。
开放平台 API（/open/v1/*）使用 HMAC-SHA256 签名鉴权：
sign_string = METHOD + "\n"
+ PATH + "\n"
+ BODY + "\n"
+ TIMESTAMP + "\n"
+ NONCE + "\n"
+ SECRET
signature = hmac_sha256(sign_string, SECRET)
请求头：
X-App-ID: 你的应用 ID X-Timestamp: 当前 Unix 时间戳(秒) X-Nonce: 随机字符串(防重放) X-Sign: HMAC-SHA256 签名(hex)