Translate Video

POST /v1/videos/:id/translate

Start an asynchronous translation job for the video's subtitles.

Growth plan required

Translation is available on Growth plans and above. Starter plans receive a 403 error.

Prerequisites

The video must be analyzed and have subtitles before translating.

Path parameters

Parameter	Type	Required	Description
id	string	Yes	Video ID

Request body

Parameter	Type	Required	Description
language	string	Yes	Target language code (minimum 2 characters, e.g. es, de, fr)

Example

curl -X POST https://api.vidocu.ai/v1/videos/vid_.../translate \
  -H "Authorization: Bearer vdo_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "es"
  }'

Response 202 Accepted

{
  "jobId": "translation_1708300000000_abc1234",
  "status": "pending"
}

If a translation is already running for this video:

Response 200 OK (existing job)

{
  "jobId": "translation_1708300000000_abc1234",
  "status": "processing",
  "message": "Translation already in progress"
}

Polling for completion

Use the Jobs endpoint to check progress, or listen for the video.translated webhook event.

Errors

Status	Code	Cause
400	validation_error	Video must be analyzed before translating, or missing language code
401	authentication_error	Invalid or missing API key
403	limit_exceeded	Translation requires Growth plan or higher
404	not_found	Video not found