技术 / 架构与实现

18 全量HTTP接口目录与动作契约

基于 Android 1.0.2 / 1.0.2-trial · 2026-10-10 · 完整正文

以下目录由当前两版app.py AST提取装饰器生成,列出显式注册路由;Flask自动静态路由、HEAD/OPTIONS不作为业务入口另行展开。接口属于APK内部协议,不是对外公开云API;示例不包含真实密钥或运行token。

版本方法路径作用/主要字段源码定位
两版GET/应用首页与同源Cookieapp/src/main/python/app.py:405
两版GET/api/session恢复本机会话;不进入模型业务app/src/main/python/app.py:414
两版GET/api/health产品版本与可用来源app/src/main/python/app.py:422
两版GET / POST/api/mobile/draft读取/保存白名单草稿app/src/main/python/app.py:451
两版GET/api/records版本及分页日志;kind、offsetapp/src/main/python/app.py:467
两版GET/api/records/exportJSON导出全部记录app/src/main/python/app.py:481
两版GET/api/jobs历史任务摘要,创建时间倒序app/src/main/python/app.py:492
两版GET/api/videos实际非空非pending成片列表app/src/main/python/app.py:542
两版GET/api/videos/<job_id>/media按filename读取保留MP4;download=1另存app/src/main/python/app.py:560
两版POST/api/videos/<job_id>/reveal兼容定位,在Android返回导出路径app/src/main/python/app.py:567
两版POST/api/videos/reveal-rootAndroid作品库入口app/src/main/python/app.py:576
两版POST/api/drawthings/check兼容路由;Android已移除该来源,拒绝配置app/src/main/python/app.py:584
两版POST/api/jobs创建任务;正文/标题/音色/图片方式app/src/main/python/app.py:590
两版GET/api/jobs/<job_id>完整job_view与三个阶段状态app/src/main/python/app.py:662
两版POST/api/jobs/<job_id>/use-image换手机/URL照片,保留MP3并清确认app/src/main/python/app.py:667
两版POST/api/jobs/<job_id>/select-images保留非空照片子集;版本检查app/src/main/python/app.py:709
两版GET/api/jobs/<job_id>/images/<int:index>当前图库指定索引图片app/src/main/python/app.py:732
两版POST/api/jobs/<job_id>/<action>动态动作:pause/resume/cancel/重试/确认等app/src/main/python/app.py:741
两版GET/api/jobs/<job_id>/media/<kind>当前ready音频/图片或done视频app/src/main/python/app.py:847
两版GET/api/preview/<voice>读取26种内置离线样音app/src/main/python/app.py:864
仅试用GET/api/mobile/trial-status累计额度+是否有已保存成片app/src/main/python/app.py:603
仅试用POST/api/mobile/trial/text正文差异计数并保存草稿正文app/src/main/python/app.py:616
仅试用POST/api/mobile/trial/photos手机照片预选计数,返回内容绑定凭据app/src/main/python/app.py:633

动态action完整枚举

POST /api/jobs/<job_id>/<action>在服务端只接受下表动作;其他action为404,不能随意推断任意命令执行。请求必须JSON,暂无额外字段时也使用{}。

action 请求关键字段 成功行为/注意
pause 无 暂停标记,不撤云端提交
resume 无 清暂停/取消,不自动重启中断步骤
cancel 无 请求停止,素材保留
retry-audio 无 用任务快照复用已完成语音分段
retry-image api_key、payment_consent、必要时confirm_resubmit 沿用任务AI模型,manual不提供AI重试
regenerate prompt及费用认证 更新要求,沿用任务模型重新生成
change-source provider、model、prompt、费用认证 从创作页配置更换可用AI来源/模型
confirm image_version ready、版本一致、无ACTIVE后启动视频
reveal 可选kind=audio/video Android返回导出路径;无kind打开作品库

共用GET媒体需应用密钥/Cookie,不需POST local token。POST统一令牌和来源保护,即使非收费动作也适用。无法直接在桌面浏览器随意使用APK随机端口接口,不存在无鉴权远程访问方式。

兼容路由的含义

/api/drawthings/check残留于共享业务代码,但Android SOURCES已移除drawthings,配置先拒绝来源,不可作为手机本机模型功能宣传。reveal类路由保留桌面分支,Android返回库/导出结构。remote_id字段兼容历史任务,Seedream当前直接b64返回单张,没有远端ID轮询恢复接口。

把这些功能用到你的内容里。

免费试用、正式版优惠授权与招商合作:微信 wzqy2019。说明你需要配音、照片视频、PC或Android端,我们一起确定适合的使用方式。

合作从一次沟通开始

让你的内容制作,
找到合适的工作台。

免费试用、优惠授权、PC与Android版本、工作室及渠道合作意向,欢迎直接咨询。

打开微信,搜索 wzqy2019,添加时备注“听文合作”。具体授权、价格与合作政策以沟通为准;本站不收款。