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

认证

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

REST API

  • 使用 REST API
  • 全部端点
  • 项目
    • 录制
      • POST
        Create a archive request
      • POST
        Create a revision
      • GET
        List checks for a dataset version
      • POST
        Create a contract check request
      • GET
        List deletion eligibility for a dataset version
      • GET
        List health for a dataset version
      • POST
        Create a health recompute request
      • GET
        List provenance summary for a dataset version
      • POST
        Create a repair task generation request
      • GET
        List reproducibility bundle for a dataset version
      • POST
        Create a split plan
      • GET
        List training jobs for a dataset version
      • GET
        List diff for a dataset version
      • POST
        Create a dataset
      • GET
        Get a dataset
      • PATCH
        Update a dataset
      • PUT
        Update a draft
      • POST
        ADR 0073: import QWen auto-annotate draft → writeback + optional search index rebuild.
      • GET
        List frame spatial annotations for a dataset
      • POST
        Create a frame spatial annotation
      • DELETE
        Delete a frame spatial annotation
      • PATCH
        Update a frame spatial annotation
      • GET
        List lineage for a dataset
      • GET
        List studio for a dataset
      • GET
        List time range annotations for a dataset
      • POST
        Create a time range annotation
      • DELETE
        Delete a time range annotation
      • PATCH
        Update a time range annotation
      • GET
        List versions for a dataset
      • GET
        List governance tags for a version
      • POST
        Create a governance tag
      • DELETE
        Delete a governance tag
      • PATCH
        Update a governance tag
      • GET
        List governance tags for a item
      • POST
        Create a governance tag
      • DELETE
        Delete a governance tag
      • PATCH
        Update a governance tag
      • GET
        Get a version
      • POST
        Create a derived version
      • GET
        List files for a version
      • GET
        List items for a version
      • GET
        List lineage for a version
      • GET
        List metadata for a version
      • GET
        List processing gate for a version
      • POST
        Create a publication request
      • POST
        Create a quality check job
      • GET
        List quality report for a version
      • GET
        List quality summary for a version
      • GET
        List signed files for a version
      • GET
        List topics for a version
      • POST
        Create a visibility restoration
      • GET
        List edges for a lineage
      • GET
        List downstream for a node
      • GET
        List upstream for a node
      • GET
        List capture sessions in a project
      • POST
        Create a capture session
      • GET
        List data contracts for a project
      • POST
        Create a data contract
      • GET
        List datasets for a project
      • GET
        List health for a project
      • GET
        List recordings in a project
      • POST
        Create a recording from an upload session or a one-way Hugging Face Hub import
      • DELETE
        Move a recording to trash
      • GET
        Get a recording
      • PATCH
        Patch recording name and tags
      • GET
        Get anonymization evidence and spot-check status for a recording
      • POST
        Create a consent-document upload for a human recording
      • POST
        Complete a consent-document upload after the object is stored
      • POST
        Confirm a privacy spot check for the latest processing result
      • GET
        What the latest processing result of a recording holds: cameras, columns, features, rate and duration
      • PUT
        Assign or clear a recording capture session
    • 上传
      • 任务片段与版本
        • 标注
          • 质量与任务
            • 检索
              • 工作流
                • 算法
                  • 模型
                    • 产物与导出
                      • 计费与用量
                        • 团队与治理
                          • 账号与通知
                            • Webhook 端点

                              事件

                              • 出站事件
                              • 签名校验

                              工具

                              • 命令行
                              • SDK
                              • MCP

                              更新

                              • 更新日志

                              © 2026 EmbodiFlow

                              llms.txtOpenAPI JSON
                              1. 开发者参考
                              2. REST API
                              3. 录制
                              4. List recordings in a project

                              List recordings in a project

                              GET
                              /v1/projects/{projectId}/recordings
                              curl -X GET 'https://api.embodiflow.io/v1/projects/{projectId}/recordings' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT'

                              认证

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

                              • Authorization: Bearer PAT
                              认证指南

                              路径参数

                              • projectIdstring必填

                              查询参数

                              • pageSizenumber

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

                              • pageTokenstring

                                Opaque page token from the previous response.

                              • qstring
                              • lifecyclestring
                                可选值
                                empty
                                uploading
                                processing
                                ready
                                failed
                                stalled
                              • privacyStatestring
                                可选值
                                pending
                                anonymized
                                refused
                              • segmentationStatestring
                                可选值
                                not_segmented
                                proposed
                                reviewed
                              • sourcestring
                                可选值
                                upload
                                collection
                                hub_import
                              • collectorIdstring (uuid)
                              • episodeCountMinnumber
                              • episodeCountMaxnumber
                              • episodeCountMaxExclusivenumber
                              • uploadedAfterstring
                              • uploadedBeforestring
                              • selectionRunIdstring (uuid)

                              响应

                              Success

                              • dataarray<RecordingDto>必填
                                • idstring必填
                                • projectIdstring必填
                                • namestring必填
                                • tagsarray<string>必填
                                • sourceFormatstring | null必填
                                • sourcestring必填
                                  可选值
                                  upload
                                  collection
                                  hub_import
                                • huggingFaceobject
                                • statusobject必填
                                • segmentationStateobject必填
                                • privacyStatestring | null必填
                                  可选值
                                  pending
                                  anonymized
                                  refused
                                • privacyRequirementstring
                                  可选值
                                  required
                                  not_required
                                • privacyGatestring
                                  可选值
                                  human
                                  non_human
                                • durationNsnumber | null必填
                                • collectorany | null必填
                                • posterUrlstring | null必填
                                • latestReadyProcessingResultIdstring | null必填
                                • processedWithobject | null必填
                                • rigProfileobject | null必填
                                • captureLabelsobject
                                • rejectedSavedMinutesnumber | null必填
                                • createdAtstring必填
                                • updatedAtstring必填
                              • nextPageTokenstring

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

                              • metaobject必填
                                • pageSizenumber必填
                                • requestIdstring
                              响应示例
                              {
                                "data": [
                                  {
                                    "id": "string",
                                    "projectId": "string",
                                    "name": "string",
                                    "tags": [
                                      "string"
                                    ],
                                    "sourceFormat": "string",
                                    "source": "upload",
                                    "huggingFace": {
                                      "type": "hugging_face",
                                      "repoId": "string",
                                      "revision": "string",
                                      "commitSha": "string",
                                      "subPath": "string",
                                      "licence": "string",
                                      "gated": "none",
                                      "sourceFormat": "lerobot-v3",
                                      "progress": {
                                        "filesDone": 0,
                                        "filesTotal": 0,
                                        "bytesDone": 0,
                                        "bytesTotal": 0
                                      },
                                      "failureReason": "HF_REPO_NOT_FOUND"
                                    },
                                    "status": {
                                      "lifecycle": "failed",
                                      "quality": "warn",
                                      "qualityCheckId": "string",
                                      "qualityVerdict": "warning",
                                      "stepId": "string",
                                      "stepWaitReason": "string",
                                      "noProgressSince": "string",
                                      "failure": {
                                        "code": "string",
                                        "reason": "string",
                                        "stepId": "string",
                                        "stepName": "string",
                                        "stepAlgorithm": {
                                          "slug": "string",
                                          "title": "string"
                                        },
                                        "stepRunId": "string",
                                        "runId": "string",
                                        "stepErrorCode": "string"
                                      },
                                      "runId": "string",
                                      "processingRefused": {
                                        "code": "string"
                                      }
                                    },
                                    "segmentationState": {
                                      "state": "not_segmented",
                                      "episodeCount": 0
                                    },
                                    "privacyState": "pending",
                                    "privacyRequirement": "required",
                                    "privacyGate": "human",
                                    "durationNs": 0,
                                    "collector": null,
                                    "posterUrl": "string",
                                    "latestReadyProcessingResultId": "string",
                                    "processedWith": {
                                      "workflowName": "string",
                                      "revision": 0
                                    },
                                    "rigProfile": {
                                      "name": "string",
                                      "revisionId": "string"
                                    },
                                    "captureLabels": {
                                      "tags": [
                                        "string"
                                      ],
                                      "scene": "string",
                                      "taskDescription": "string"
                                    },
                                    "rejectedSavedMinutes": 0,
                                    "createdAt": "string",
                                    "updatedAt": "string"
                                  }
                                ],
                                "nextPageToken": "string",
                                "meta": {
                                  "pageSize": 0,
                                  "requestId": "string"
                                }
                              }
                              服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1
                              上一页

                              GET /projects/{projectId}/health

                              下一页

                              POST /projects/{projectId}/recordings

                              curl -X GET 'https://api.embodiflow.io/v1/projects/{projectId}/recordings' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT'
                              响应示例
                              状态码
                              200
                              ​
                              {
                                "data": [
                                  {
                                    "id": "string",
                                    "projectId": "string",
                                    "name": "string",
                                    "tags": [
                                      "string"
                                    ],
                                    "sourceFormat": "string",
                                    "source": "upload",
                                    "huggingFace": {
                                      "type": "hugging_face",
                                      "repoId": "string",
                                      "revision": "string",
                                      "commitSha": "string",
                                      "subPath": "string",
                                      "licence": "string",
                                      "gated": "none",
                                      "sourceFormat": "lerobot-v3",
                                      "progress": {
                                        "filesDone": 0,
                                        "filesTotal": 0,
                                        "bytesDone": 0,
                                        "bytesTotal": 0
                                      },
                                      "failureReason": "HF_REPO_NOT_FOUND"
                                    },
                                    "status": {
                                      "lifecycle": "failed",
                                      "quality": "warn",
                                      "qualityCheckId": "string",
                                      "qualityVerdict": "warning",
                                      "stepId": "string",
                                      "stepWaitReason": "string",
                                      "noProgressSince": "string",
                                      "failure": {
                                        "code": "string",
                                        "reason": "string",
                                        "stepId": "string",
                                        "stepName": "string",
                                        "stepAlgorithm": {
                                          "slug": "string",
                                          "title": "string"
                                        },
                                        "stepRunId": "string",
                                        "runId": "string",
                                        "stepErrorCode": "string"
                                      },
                                      "runId": "string",
                                      "processingRefused": {
                                        "code": "string"
                                      }
                                    },
                                    "segmentationState": {
                                      "state": "not_segmented",
                                      "episodeCount": 0
                                    },
                                    "privacyState": "pending",
                                    "privacyRequirement": "required",
                                    "privacyGate": "human",
                                    "durationNs": 0,
                                    "collector": null,
                                    "posterUrl": "string",
                                    "latestReadyProcessingResultId": "string",
                                    "processedWith": {
                                      "workflowName": "string",
                                      "revision": 0
                                    },
                                    "rigProfile": {
                                      "name": "string",
                                      "revisionId": "string"
                                    },
                                    "captureLabels": {
                                      "tags": [
                                        "string"
                                      ],
                                      "scene": "string",
                                      "taskDescription": "string"
                                    },
                                    "rejectedSavedMinutes": 0,
                                    "createdAt": "string",
                                    "updatedAt": "string"
                                  }
                                ],
                                "nextPageToken": "string",
                                "meta": {
                                  "pageSize": 0,
                                  "requestId": "string"
                                }
                              }