Register task

Calling this endpoint registers a task for computing tennis statistics for the provided video denoted by video_url.

POST

/api/statistics/tennis

Authorization

AuthorizationBearer <token>required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

video_urlstringrequired

Example"https://example.com/video/3cab8744-fd22-4efe-a5f4-9a7fc8ad3716.mp4"

processing_windowsarray<object>optional

start_timenumberoptional

Timestamp in seconds for where to start processing

Example200

stop_timenumberoptional

Timestamp in seconds for where to stop processing

Example650

only_in_rally_databooleanoptional

Defaultfalse

read_video_from_originbooleanoptional

When true (default), the video is read directly from the provided URL. When false, the video is first downloaded to SportAI servers before processing.

Defaulttrue

versionstringoptional

Default"stable"

Example"latest"

Response Body

Task was successfully created

application/json

dataobjectoptional

task_idstring<uuid>required

Example"52921d5c-eb41-45d6-96a8-f2da5616c717"

estimated_compute_timenumberoptional

curl -X POST "https://example.com/api/statistics/tennis" \  -H "Content-Type: application/json" \  -d '{    "video_url": "https://example.com/video/3cab8744-fd22-4efe-a5f4-9a7fc8ad3716.mp4"  }'

{  "data": {    "task_id": "52921d5c-eb41-45d6-96a8-f2da5616c717",    "estimated_compute_time": 0  }}