مسودة: يصف هذا التوثيق أوكتا فيديو كما ستكون عند الإطلاق، وقد لا تكون بعض الميزات متاحة بعد.
OctaVideoالتوثيق

Transcribe a video

POST
/videos/{videoId}/transcribe

Starts a transcription of the video's speech. The body is optional: leave out language to auto-detect it. Transcription runs in the background, so the response is 202 Accepted with a job_id.

Authorization

AccessKey
headerAccessKey<token>

The private key of a library, starting with ovk_. Copy it from API & embeds in the console, keep it on your server, and rotate it there if it leaks.

Path Parameters

videoId*string

ID of the video.

Formatuuid

Header Parameters

AccessKey*string

The library's private key. Same value as the AccessKey security scheme; listed here so code samples include it.

Request Body

application/json
  1. body
language?string

BCP 47 language tag of the speech, such as ar or en-US. Leave it out to auto-detect.

Response Body

The transcription job was accepted.

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.octavideo.tech/api/v1/videos/6f1c2b9e-4a7d-4f3e-9b8a-2d5c7e1f0a34/transcribe' \  -H 'AccessKey: ovk_YOUR_LIBRARY_PRIVATE_KEY' \  -H 'Content-Type: application/json' \  -d '{  "language": "ar"}'
Example Response
{  "data": {    "job_id": "c92e1b7a-3f4d-4a8e-9b0c-1d2e3f4a5b6c"  }}