Vision Event 번들 업로드

에어갭 배포가 작성한 tarball 번들을 수집하여 Vision Event를 생성합니다.

소개

그 비전 이벤트 번들 쓰기 블록은 Roboflow로 보내는 대신 이벤트마다 하나의 tarball을 로컬 디스크에 씁니다. 추론 서버가 클라우드로 가는 경로가 없는 네트워크에서 실행될 때 사용하세요. 이 엔드포인트는 이러한 tarball을 있는 그대로 받습니다: 업로더가 각 파일을 전송하면 Roboflow가 이를 압축 해제하고, 이미지를 업로드하며, 생성합니다. 비전 이벤트.

HTTP API

원시 아카이브 바이트를 요청 본문으로 전송하세요. JSON이나 multipart를 사용하지 마세요. 본문은 바이너리이므로, API 키를 Authorization: Bearer 헤더 또는 api_key 쿼리 매개변수에 보내세요.

필요한 권한 범위: vision-events:write 또는 device:update

Upload a Vision Event Bundle

post

Create one vision event from a self-contained tarball bundle written by the Write Vision Event Bundle workflow block. Post the raw archive bytes as the body.

Authorizations

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Query parameters

useCaseIdstring · max: 256Optional

The use case the event belongs to. This overrides the useCaseId inside payload.json. Required when the bundle does not carry one.

Body

string · binaryOptional

Gzipped tar archive holding payload.json and its image members.

Responses

201

Event created successfully.

application/json

eventIdstringOptionalExample: a1b2c3d4-e5f6-7890-abcd-ef1234567890

createdbooleanOptionalExample: true

deprecationsstring[]Optional

400

Bad archive, bad payload, more than 100 images, or no use case in the query or the payload.

application/json

403

Insufficient permissions for this resource.

application/json

413

A size limit was exceeded.

application/json

post/vision-events/bundle

POST /vision-events/bundle HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/gzip
Accept: */*
Content-Length: 8

"binary"

{
  "eventId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created": true,
  "images": [
    {
      "file": "images/9f0c1b2a-4d3e-4f5a-8b6c-7d8e9f0a1b2c.jpg",
      "sourceId": "src_abc123"
    }
  ],
  "warnings": [
    {
      "type": "text",
      "path": "text",
      "value": "text",
      "valueType": "text"
    }
  ],
  "deprecations": [
    "text"
  ]
}

번들 형식

각 번들은 하나의 이벤트를 담습니다. 블록은 gzipped tar 파일을 쓰며, 일반 tar도 사용할 수 있습니다.

event_<timestamp>_<eventId>.tar.gz
├── payload.json
└── images/<file_id>.jpg

payload.json 은 비전 이벤트 만들기 요청 본문과 동일한 구조를 가지며, 두 가지 차이점이 있습니다:

• bundleFormatVersion 는 1.

• images[].file 및 images[].inputFile 아카이브 멤버 경로를 담습니다(예: images/9f0c1b2a.jpg) 대신 sourceId 및 inputSourceId. Roboflow가 각 멤버를 업로드하고 소스 ID를 이벤트에 저장합니다.

이미지는 아래에 있어야 합니다 images/ 디렉터리. 어떤 이미지도 참조하지 않는 멤버와, images/이외의 최상위 디렉터리는 수집 경고를 추가하지만 이벤트는 중단하지 않습니다.

내부의 필드 오류는 payload.json JSON 엔드포인트와 동일하게 동작합니다. 참조: 유효성 검사 및 경고.

사용 사례

그 useCaseId 쿼리 매개변수가 이를 덮어씁니다 useCaseId 에서 payload.json. 둘 중 어느 것도 설정되지 않으면 요청은 400으로 실패합니다. 에어갭 사이트에서는 일반적으로 번들에서 사용 사례를 제외하여 로컬 네트워크 내부에 클라우드 식별자가 저장되지 않도록 하고, 대신 업로드 시점에 설정합니다.

제한

제한	값	실패 시 상태
요청 본문	25 MB	413
압축 해제된 아카이브	75 MB	413
payload.json	10 MB	413
아카이브 항목	217	413
번들당 이미지 수	100	400
이미지당 픽셀 수	80 MP	413

재시도

업로드가 실패했거나 불분명한 경우 동일한 번들을 다시 전송할 수 있습니다. 이미지는 콘텐츠로 매칭되며, 두 번 도착한 이벤트는 이전 이벤트를 대체합니다. 이에 대해서는 한 번만 청구됩니다.