API 通用约定
服务边界、响应格式、鉴权及任务标识的阅读入口
更新时间：2026年09月08日 13时20分03秒（UTC+8）
先确认接口所属服务
本项目存在多种响应结构，以下是现有契约分类，不是一次接口格式变更。不要将 VDE 的 JSON envelope 套用到 Proxy、Partner 或 Agent。
| 调用场景 | 鉴权与入口 | 详细契约 |
|---|---|---|
| 画布与工作台 | 网站登录态，/api/proxy/v1/* | GPU API |
| 外部业务系统 | Partner Bearer Key | Partner API |
| 数据集服务 | BFF 代注入服务 Token | VDE 响应和 SSE |
| 角色发布 | 登录态 BFF；机器读取使用独立服务凭据 | 角色发布接口 |
| Skill 管理 | 登录态；归档存储使用内部服务凭据 | Skill API |
| Agent / Harness | 区分网站会话与本地 Agent Token | Agent API |
| 账户核验 | 当前网站登录账户 | 计费查询 |
不要混用三类标识
- Request ID：定位一次 HTTP 请求，格式与响应头以所属服务契约为准。
- Operation ID / 幂等键：标识一次业务提交；重试同一提交应保留原值和输入。
- Task ID / Run ID：创建响应返回的任务或运行标识，不用请求 ID 推测或替代。
状态与重试
HTTP 请求成功、任务已入队、生成已完成、积分已结算、人工质量验收通过是不同状态。 网络超时不证明任务未执行；先查既有任务及账单，再决定下一步。 取消连接不等于取消 GPU 任务或退款；实际语义见各业务契约。
文档状态说明
“开发候选”是历史标记，不能单凭它判断当前生产状态。核验时分别记录：代码实现、隔离测试、部署 SHA、线上验收。 没有发布证据时不将状态改成“已上线”。测试过程和剩余事项分别见 待验收 与 待办。 更新时间指本页实际修订时间，不是服务部署时间。
旧章节入口
下列标题保留原层级，兼容已有锚点。业务正文已按职责拆分，不再在本页重复维护。
JSON envelope
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
服务鉴权
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Priya Live 发布接口
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Job SSE
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
GPU 调度器只读状态
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Krea2 姿势 LoRA
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
明星 GirlsLike Krea2 图像 API
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Skill 历史查询（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
当前账户操作核验（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
本地 Agent 任务解释（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Skill 执行引用回读（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
网站聊天绑定 Skill 上下文（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
网站 Agent 连接取消
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Skill 归档内部读写（候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
管理员 Skill 归档策略（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Skill 归档策略候选预览
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
本地 Agent DAG 提案
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
本地 Agent 确认决定保存屏障
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
本地 Agent 计划发现
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
画布工具规划模式
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
本机 Agent 队列暂停诊断
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
计划描述性输入上下文
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
本机 Agent 计划列表
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
本机 Agent 暂停提交
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
计划快照只读结构检查（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
计划生成请求存储（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
计划步骤输入准备（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
执行尝试进度（开发候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
计划审批决定
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
已保存计划修订定位
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
Agent 计划入队（候选）
此章节已迁至 对应业务接口文档，请按原章节名称查阅。
准备审批确认材料（候选）
见 Agent 审批确认材料。