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. Update a draft

                              Update a draft

                              PUT
                              /v1/datasets/{datasetId}/annotations/draft
                              curl -X PUT 'https://api.embodiflow.io/v1/datasets/{datasetId}/annotations/draft' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
                                -H 'Content-Type: application/json' \
                                -d '{
                                  "datasetVersionId": "00000000-0000-0000-0000-000000000000",
                                  "timeRangeAnnotations": [
                                    {
                                      "datasetVersionId": "00000000-0000-0000-0000-000000000000",
                                      "annotationSchemaId": "00000000-0000-0000-0000-000000000000",
                                      "segmentKind": "action",
                                      "startSec": 0,
                                      "startNsec": 0,
                                      "endSec": 0,
                                      "endNsec": 0,
                                      "timeReference": "string",
                                      "title": "string",
                                      "naturalLanguageInstruction": "string",
                                      "success": true,
                                      "score": 0,
                                      "failureReason": "string",
                                      "parentId": "00000000-0000-0000-0000-000000000000",
                                      "orderIndex": 0,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "attributesJson": {}
                                    }
                                  ],
                                  "frameSpatialAnnotations": [
                                    {
                                      "datasetVersionId": "00000000-0000-0000-0000-000000000000",
                                      "datasetVersionFileId": "00000000-0000-0000-0000-000000000000",
                                      "frameIndex": 0,
                                      "frameStampSec": 0,
                                      "frameStampNsec": 0,
                                      "timeReference": "string",
                                      "datasetClassId": "00000000-0000-0000-0000-000000000000",
                                      "className": "string",
                                      "trackId": "string",
                                      "trackKey": "string",
                                      "bboxX": 0,
                                      "bboxY": 0,
                                      "bboxWidth": 0,
                                      "bboxHeight": 0,
                                      "occluded": true,
                                      "truncated": true,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "attributesJson": {}
                                    }
                                  ]
                                }'

                              认证

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

                              • Authorization: Bearer PAT
                              认证指南

                              路径参数

                              • datasetIdstring必填

                              请求体

                              Content-Typeapplication/json
                              • datasetVersionIdstring (uuid) | null

                                ADR 0172 D6 optional version scope; additive, omission keeps legacy behavior.

                              • timeRangeAnnotationsarray<CreateDatasetTimeRangeAnnotationBodyDto>必填
                                • datasetVersionIdstring (uuid) | null
                                • annotationSchemaIdstring (uuid) | null
                                • segmentKindstring
                                  可选值
                                  action
                                  segment
                                  event
                                  phase
                                  quality-issue
                                  task
                                  subtask
                                  skill
                                • startSecnumber必填
                                • startNsecnumber
                                • endSecnumber必填
                                • endNsecnumber
                                • timeReferencestring必填
                                • titlestring | null
                                • naturalLanguageInstructionstring | null
                                • successboolean | null
                                • scorenumber | null
                                • failureReasonstring | null
                                • parentIdstring (uuid) | null
                                • orderIndexnumber
                                • reviewStatusstring
                                • statusstring
                                • attributesJsonobject | null
                              • frameSpatialAnnotationsarray<CreateDatasetFrameSpatialAnnotationBodyDto>必填
                                • datasetVersionIdstring (uuid) | null
                                • datasetVersionFileIdstring (uuid)必填
                                • frameIndexnumber必填
                                • frameStampSecnumber | null
                                • frameStampNsecnumber | null
                                • timeReferencestring必填
                                • datasetClassIdstring (uuid) | null
                                • classNamestring | null
                                • trackIdstring | null
                                • trackKeystring | null
                                • bboxXnumber必填
                                • bboxYnumber必填
                                • bboxWidthnumber必填
                                • bboxHeightnumber必填
                                • occludedboolean | null
                                • truncatedboolean | null
                                • reviewStatusstring
                                • statusstring
                                • attributesJsonobject | null

                              响应

                              Success

                              • dataobject必填
                                • timeRangeAnnotationsarray<DatasetTimeRangeAnnotationDto>必填
                                • frameSpatialAnnotationsarray<DatasetFrameSpatialAnnotationDto>必填
                              响应示例
                              {
                                "data": {
                                  "timeRangeAnnotations": [
                                    {
                                      "id": "string",
                                      "tenantId": "string",
                                      "projectId": "string",
                                      "datasetId": "string",
                                      "datasetVersionId": "string",
                                      "annotationSchemaId": "string",
                                      "segmentKind": "string",
                                      "startSec": 0,
                                      "startNsec": 0,
                                      "endSec": 0,
                                      "endNsec": 0,
                                      "timeReference": "string",
                                      "title": "string",
                                      "naturalLanguageInstruction": "string",
                                      "success": false,
                                      "score": 0,
                                      "failureReason": "string",
                                      "parentId": "string",
                                      "orderIndex": 0,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "publishedSnapshotId": "string",
                                      "createdBy": "string",
                                      "updatedBy": "string",
                                      "createdAt": "string",
                                      "updatedAt": "string",
                                      "deletedAt": "string",
                                      "attributesJson": {}
                                    }
                                  ],
                                  "frameSpatialAnnotations": [
                                    {
                                      "id": "string",
                                      "tenantId": "string",
                                      "projectId": "string",
                                      "datasetId": "string",
                                      "datasetVersionId": "string",
                                      "datasetVersionFileId": "string",
                                      "frameIndex": 0,
                                      "frameStampSec": 0,
                                      "frameStampNsec": 0,
                                      "timeReference": "string",
                                      "datasetClassId": "string",
                                      "className": "string",
                                      "trackId": "string",
                                      "trackKey": "string",
                                      "bboxX": 0,
                                      "bboxY": 0,
                                      "bboxWidth": 0,
                                      "bboxHeight": 0,
                                      "occluded": false,
                                      "truncated": false,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "publishedSnapshotId": "string",
                                      "createdBy": "string",
                                      "updatedBy": "string",
                                      "createdAt": "string",
                                      "updatedAt": "string",
                                      "deletedAt": "string",
                                      "attributesJson": {}
                                    }
                                  ]
                                }
                              }
                              服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1
                              上一页

                              PATCH /datasets/{datasetId}

                              下一页

                              POST /datasets/{datasetId}/auto-annotate-imports

                              curl -X PUT 'https://api.embodiflow.io/v1/datasets/{datasetId}/annotations/draft' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
                                -H 'Content-Type: application/json' \
                                -d '{
                                  "datasetVersionId": "00000000-0000-0000-0000-000000000000",
                                  "timeRangeAnnotations": [
                                    {
                                      "datasetVersionId": "00000000-0000-0000-0000-000000000000",
                                      "annotationSchemaId": "00000000-0000-0000-0000-000000000000",
                                      "segmentKind": "action",
                                      "startSec": 0,
                                      "startNsec": 0,
                                      "endSec": 0,
                                      "endNsec": 0,
                                      "timeReference": "string",
                                      "title": "string",
                                      "naturalLanguageInstruction": "string",
                                      "success": true,
                                      "score": 0,
                                      "failureReason": "string",
                                      "parentId": "00000000-0000-0000-0000-000000000000",
                                      "orderIndex": 0,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "attributesJson": {}
                                    }
                                  ],
                                  "frameSpatialAnnotations": [
                                    {
                                      "datasetVersionId": "00000000-0000-0000-0000-000000000000",
                                      "datasetVersionFileId": "00000000-0000-0000-0000-000000000000",
                                      "frameIndex": 0,
                                      "frameStampSec": 0,
                                      "frameStampNsec": 0,
                                      "timeReference": "string",
                                      "datasetClassId": "00000000-0000-0000-0000-000000000000",
                                      "className": "string",
                                      "trackId": "string",
                                      "trackKey": "string",
                                      "bboxX": 0,
                                      "bboxY": 0,
                                      "bboxWidth": 0,
                                      "bboxHeight": 0,
                                      "occluded": true,
                                      "truncated": true,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "attributesJson": {}
                                    }
                                  ]
                                }'
                              响应示例
                              状态码
                              200
                              ​
                              {
                                "data": {
                                  "timeRangeAnnotations": [
                                    {
                                      "id": "string",
                                      "tenantId": "string",
                                      "projectId": "string",
                                      "datasetId": "string",
                                      "datasetVersionId": "string",
                                      "annotationSchemaId": "string",
                                      "segmentKind": "string",
                                      "startSec": 0,
                                      "startNsec": 0,
                                      "endSec": 0,
                                      "endNsec": 0,
                                      "timeReference": "string",
                                      "title": "string",
                                      "naturalLanguageInstruction": "string",
                                      "success": false,
                                      "score": 0,
                                      "failureReason": "string",
                                      "parentId": "string",
                                      "orderIndex": 0,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "publishedSnapshotId": "string",
                                      "createdBy": "string",
                                      "updatedBy": "string",
                                      "createdAt": "string",
                                      "updatedAt": "string",
                                      "deletedAt": "string",
                                      "attributesJson": {}
                                    }
                                  ],
                                  "frameSpatialAnnotations": [
                                    {
                                      "id": "string",
                                      "tenantId": "string",
                                      "projectId": "string",
                                      "datasetId": "string",
                                      "datasetVersionId": "string",
                                      "datasetVersionFileId": "string",
                                      "frameIndex": 0,
                                      "frameStampSec": 0,
                                      "frameStampNsec": 0,
                                      "timeReference": "string",
                                      "datasetClassId": "string",
                                      "className": "string",
                                      "trackId": "string",
                                      "trackKey": "string",
                                      "bboxX": 0,
                                      "bboxY": 0,
                                      "bboxWidth": 0,
                                      "bboxHeight": 0,
                                      "occluded": false,
                                      "truncated": false,
                                      "reviewStatus": "string",
                                      "status": "string",
                                      "publishedSnapshotId": "string",
                                      "createdBy": "string",
                                      "updatedBy": "string",
                                      "createdAt": "string",
                                      "updatedAt": "string",
                                      "deletedAt": "string",
                                      "attributesJson": {}
                                    }
                                  ]
                                }
                              }