EmbodiFlow文档
开始使用数据工作流与算法训练与部署开发者参考
  • 开发者参考

认证

  • 认证概览
  • API 密钥
  • 个人访问令牌
  • 浏览器会话

REST API

  • 使用 REST API
  • 全部端点
  • 项目
    • 录制
      • 上传
        • 任务片段与版本
          • 标注
            • 质量与任务
              • 检索
                • GET
                  Asset cards across dataset versions and artifacts.
                • GET
                  Single asset card with recent events.
                • POST
                  Preview a structured query against canonical parquet for one dataset version.
                • GET
                  L0 Postgres coarse filter across dataset versions visible to the caller.
                • GET
                  Facet counts for the same visible version scope as dataset-versions list.
                • GET
                  How many recordings are not in the search index yet.
                • POST
                  Explicit team Owner/Admin action: build the search profile for recordings processed before indexing existed. Derived cache, never dataset history.
                • POST
                  Structured + optional semantic catalog search (ADR 0012 / 0014).
                • GET
                  Structured catalog search schema for query builders (ADR 0012).
                • GET
                  Search this team for projects, recordings, versions, and commands
              • 工作流
                • 算法
                  • 模型
                    • 产物与导出
                      • 计费与用量
                        • 团队与治理
                          • 账号与通知
                            • Webhook 端点

                              事件

                              • 出站事件
                              • 签名校验

                              工具

                              • 命令行
                              • SDK
                              • MCP

                              更新

                              • 更新日志

                              © 2026 EmbodiFlow

                              llms.txtOpenAPI JSON
                              1. 开发者参考
                              2. REST API
                              3. 检索
                              4. L0 Postgres coarse filter across dataset versions visible to the caller.

                              L0 Postgres coarse filter across dataset versions visible to the caller.

                              GET
                              /v1/catalog/dataset-versions
                              curl -X GET 'https://api.embodiflow.io/v1/catalog/dataset-versions' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT'

                              认证

                              每个请求都需要携带个人访问令牌(PAT)。

                              • Authorization: Bearer PAT
                              认证指南

                              查询参数

                              • pageSizenumber

                                Page size (default 25, maximum 100). Over-maximum is refused.

                              • pageTokenstring

                                Opaque page token from the previous response.

                              • sortBystring
                                可选值
                                updatedAt
                                createdAt
                                version
                              • sortOrderstring
                                可选值
                                asc
                                desc
                              • projectIdstring (uuid)
                              • datasetIdstring (uuid)
                              • sourceTypestring
                              • dataSourcestring
                                可选值
                                ego_human
                              • metadataTypestring
                              • qualityStatusstring
                              • statusstring
                              • fpsMinnumber
                              • fpsMaxnumber
                              • lerobotEpisodeCountMinnumber
                              • lerobotEpisodeCountMaxnumber
                              • frameCountMinnumber
                              • frameCountMaxnumber
                              • startTimeNsMinnumber
                              • startTimeNsMaxnumber
                              • endTimeNsMinnumber
                              • endTimeNsMaxnumber
                              • metadataKeystring
                                可选值
                                profile
                                task
                                robotType
                                cameraCount
                                fpsBucket
                              • metadataEqualsstring
                              • includeSoftHiddenboolean

                              响应

                              Success

                              • dataarray<CatalogDatasetVersionSummaryDto>必填
                                • idstring必填
                                • projectIdstring必填
                                • datasetIdstring必填
                                • datasetNamestring必填
                                • sourceTypestring必填
                                • dataSourcestring | null
                                • episodeStatisticsGranularitystring
                                  可选值
                                  coarse
                                • versionnumber必填
                                • versionNamestring | null必填
                                • descriptionstring | null必填
                                • statusstring必填
                                • manifestVersionnumber
                                • metadataTypestring | null
                                • codebaseVersionstring | null
                                • episodeCountnumber | null
                                • lerobotEpisodeCountnumber | null
                                • featureCountnumber | null
                                • fpsnumber | null
                                • topicCountnumber | null
                                • frameCountnumber | null
                                • startTimeNsnumber | null
                                • endTimeNsnumber | null
                                • metadataProjectionJsonobject | null
                                • itemCountnumber必填
                                • totalBytesnumber | null必填
                                • finalizedAtstring | null必填
                                • createdAtstring必填
                                • updatedAtstring必填
                                • qualityStatusstring
                                • visibilityStatusstring
                                  可选值
                                  active
                                  soft_hidden
                                • assetHealthobject
                              • metaobject必填
                                • pageSizenumber必填
                                • requestIdstring
                              • nextPageTokenstring

                                Opaque AIP-158 page token. Omitted when the collection is exhausted.

                              响应示例
                              {
                                "data": [
                                  {
                                    "id": "string",
                                    "projectId": "string",
                                    "datasetId": "string",
                                    "datasetName": "string",
                                    "sourceType": "string",
                                    "dataSource": "string",
                                    "episodeStatisticsGranularity": "coarse",
                                    "version": 0,
                                    "versionName": "string",
                                    "description": "string",
                                    "status": "string",
                                    "manifestVersion": 0,
                                    "metadataType": "string",
                                    "codebaseVersion": "string",
                                    "episodeCount": 0,
                                    "lerobotEpisodeCount": 0,
                                    "featureCount": 0,
                                    "fps": 0,
                                    "topicCount": 0,
                                    "frameCount": 0,
                                    "startTimeNs": 0,
                                    "endTimeNs": 0,
                                    "metadataProjectionJson": {},
                                    "itemCount": 0,
                                    "totalBytes": 0,
                                    "finalizedAt": "string",
                                    "createdAt": "string",
                                    "updatedAt": "string",
                                    "qualityStatus": "string",
                                    "visibilityStatus": "active",
                                    "assetHealth": {
                                      "healthStatus": "failed",
                                      "lastEventAt": "string",
                                      "summary": "string",
                                      "qualityStatus": "string"
                                    }
                                  }
                                ],
                                "meta": {
                                  "pageSize": 0,
                                  "requestId": "string"
                                },
                                "nextPageToken": "string"
                              }
                              服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1
                              上一页

                              POST /catalog/dataset-version-queries

                              下一页

                              GET /catalog/facets

                              curl -X GET 'https://api.embodiflow.io/v1/catalog/dataset-versions' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT'
                              响应示例
                              状态码
                              200
                              ​
                              {
                                "data": [
                                  {
                                    "id": "string",
                                    "projectId": "string",
                                    "datasetId": "string",
                                    "datasetName": "string",
                                    "sourceType": "string",
                                    "dataSource": "string",
                                    "episodeStatisticsGranularity": "coarse",
                                    "version": 0,
                                    "versionName": "string",
                                    "description": "string",
                                    "status": "string",
                                    "manifestVersion": 0,
                                    "metadataType": "string",
                                    "codebaseVersion": "string",
                                    "episodeCount": 0,
                                    "lerobotEpisodeCount": 0,
                                    "featureCount": 0,
                                    "fps": 0,
                                    "topicCount": 0,
                                    "frameCount": 0,
                                    "startTimeNs": 0,
                                    "endTimeNs": 0,
                                    "metadataProjectionJson": {},
                                    "itemCount": 0,
                                    "totalBytes": 0,
                                    "finalizedAt": "string",
                                    "createdAt": "string",
                                    "updatedAt": "string",
                                    "qualityStatus": "string",
                                    "visibilityStatus": "active",
                                    "assetHealth": {
                                      "healthStatus": "failed",
                                      "lastEventAt": "string",
                                      "summary": "string",
                                      "qualityStatus": "string"
                                    }
                                  }
                                ],
                                "meta": {
                                  "pageSize": 0,
                                  "requestId": "string"
                                },
                                "nextPageToken": "string"
                              }