Video-to-Text (Transcription)

This endpoint currently accepts YouTube URLs only (no direct file uploads) and transcribes the video audio. The API returns a written transcript along with a task ID for tracking processing progress.

post

Endpoint for requesting video transcription

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
Acceptstring · enumRequiredDefault: application/jsonPossible values:
Body
video_urlstringRequired

URL of video to transcribe

Example: https://www.youtube.com/watch?v=jNQXAC9IVRw
include_tsbooleanRequired

Should transcription include timestamps

modelstringOptional

The model to use for transcription. Available models can be retrieved via the GET /api/v1/client/models endpoint.

Example: WhisperLargeV3
return_result_in_responseboolean | nullableOptional

If true, the result will be returned directly in the response instead of only download url. Optional parameter.

Default: falseExample: false
Responses
200

ID of the inference request.

application/json
post
/api/v1/client/vid2txt
POST /api/v1/client/vid2txt HTTP/1.1
Host: api.deapi.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json
Content-Type: application/json
Content-Length: 136

{
  "video_url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
  "include_ts": true,
  "model": "WhisperLargeV3",
  "return_result_in_response": false
}
{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}
post

Endpoint for calculating price for video to text inference

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
Acceptstring · enumRequiredDefault: application/jsonPossible values:
Body
video_urlstringRequired

URL of video to transcribe

Example: https://www.youtube.com/watch?v=jNQXAC9IVRw
include_tsbooleanRequired

Should transcription include timestamps

modelstringOptional

The model to use for transcription. Available models can be retrieved via the GET /api/v1/client/models endpoint.

Example: WhisperLargeV3
Responses
200

Calculated price for video to text inference.

application/json
post
/api/v1/client/vid2txt/price-calculation
POST /api/v1/client/vid2txt/price-calculation HTTP/1.1
Host: api.deapi.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json
Content-Type: application/json
Content-Length: 102

{
  "video_url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
  "include_ts": true,
  "model": "WhisperLargeV3"
}
{
  "data": {
    "price": 0.25
  }
}
PreviousImage-to-ImageNextUpload Video File (Video-to-Text)

Last updated