以下目录由当前两版app.py AST提取装饰器生成,列出显式注册路由;Flask自动静态路由、HEAD/OPTIONS不作为业务入口另行展开。接口属于APK内部协议,不是对外公开云API;示例不包含真实密钥或运行token。
| 版本 | 方法 | 路径 | 作用/主要字段 | 源码定位 |
|---|---|---|---|---|
| 两版 | GET | / | 应用首页与同源Cookie | app/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、offset | app/src/main/python/app.py:467 |
| 两版 | GET | /api/records/export | JSON导出全部记录 | 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-root | Android作品库入口 | 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轮询恢复接口。