开发者参考 · EmbodiFlow 文档

开发者参考

认证、调用 REST API、接收 Webhooks，并通过 CLI 与 SDK 自动化 EmbodiFlow。

认证

认证概览

不同场合用哪种凭据：浏览器会话、个人访问令牌和 API 密钥。

API 密钥

用于团队共享自动化的 API 密钥：创建时限定范围，一定会过期，管理员可以随时撤销。

个人访问令牌

个人访问令牌：你自己用于命令行和集成的凭据，限定范围、会过期。

浏览器会话

控制台登录是怎么工作的，以及如何让不再使用的设备退出登录。

REST API

使用 REST API

基于 HTTPS 的 JSON API，使用 Bearer 令牌认证。这里是所有端点共同遵守的约定。

全部端点

浏览生成的 OpenAPI 中的全部公开操作。

项目

项目相关的公开 REST 操作。

录制

录制相关的公开 REST 操作。

上传

上传相关的公开 REST 操作。

任务片段与版本

任务片段与版本相关的公开 REST 操作。

标注

标注相关的公开 REST 操作。

质量与任务

质量与任务相关的公开 REST 操作。

检索

检索相关的公开 REST 操作。

工作流

工作流相关的公开 REST 操作。

算法

算法相关的公开 REST 操作。

模型

模型相关的公开 REST 操作。

产物与导出

产物与导出相关的公开 REST 操作。

计费与用量

计费与用量相关的公开 REST 操作。

团队与治理

团队与治理相关的公开 REST 操作。

账号与通知

账号与通知相关的公开 REST 操作。

Webhook 端点

Webhook 端点相关的公开 REST 操作。

事件

出站事件

工作一完成就收到 HTTP 通知：添加 Webhook 端点，选择事件，并在控制台查看投递情况。

签名校验

确认 Webhook 确实来自 EmbodiFlow：HMAC-SHA256 校验方法、请求头、时间窗口和完整示例。

工具

命令行

embodiflow 命令（别名 ef）：登录、上传、导出并下载版本。

SDK

由公开 OpenAPI 文档生成的 TypeScript 与 Python 客户端。

更新

更新日志

EmbodiFlow 面向用户的变更。

控制台里能做的事，都可以写成脚本。控制台、命令行和 SDK 调用的是同一套公开 REST API，按场景挑一个就好：在终端里批量上传、下载用命令行，在自己的代码里用 SDK，想完全掌控就直接发 HTTP 请求。

你想要……	从这里开始
为脚本准备凭据	认证
直接调用 API	REST API，再查看全部端点
在终端上传、导出和下载	命令行
用 TypeScript 或 Python 调用 API	SDK
工作完成时收到通知	出站事件和签名校验
编写自己的算法	自定义算法
查看更新内容	更新日志