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

听文视频工作台 · 技术架构与实现 · 1.0.2

以下目录由当前两版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轮询恢复接口。

---
招商合作微信：wzqy2019。添加备注：听文合作。
原网页：https://tingwen-creator-studio-102.pages.dev/guide/technical-18