## Get a video translation request

`video_translate.requests.retrieve(strid)  -> RequestRetrieveResponse`

**get** `/v1/video-translate/requests/{id}`

Returns an account-owned request by UUID or exact reference ID (requests of other accounts return 404). Completed artifact URLs are freshly signed on every read; SRT content is never returned.

### Parameters

- `id: str`

### Returns

- `class RequestRetrieveResponse: …`

  - `id: str`

  - `config: Config`

    The request config as returned by the API. SRT content is replaced by metadata, `speaker_voices` keys are canonical speaker IDs, and other keys are returned unchanged.

    - `source_srt: Optional[ConfigSourceSrt]`

      Public description of a supplied SRT. The subtitle content is never returned.

      - `supplied: Literal[true]`

        - `true`

      - `file_name: Optional[str]`

      - `language: Optional[str]`

    - `speaker_voices: Optional[Dict[str, str]]`

    - `target_srts: Optional[Dict[str, ConfigTargetSrts]]`

      - `supplied: Literal[true]`

        - `true`

      - `file_name: Optional[str]`

      - `language: Optional[str]`

    - `tts_model: Optional[Literal["eleven_v4", "eleven_multilingual_v2"]]`

      The explicitly selected text-to-speech model. Omitted when the request used the default.

      - `"eleven_v4"`

      - `"eleven_multilingual_v2"`

  - `created_at: datetime`

  - `disable_background_audio: bool`

    Whether background audio was disabled for this request.

  - `disable_lip_sync: bool`

    Whether lip sync was disabled for this request.

  - `formality: bool`

  - `model: Literal["expressive", "classic"]`

    Product speech model selected for the request.

    - `"expressive"`

    - `"classic"`

  - `status: Literal["queued", "uploading", "processing", 2 more]`

    - `"queued"`

    - `"uploading"`

    - `"processing"`

    - `"completed"`

    - `"failed"`

  - `target_languages: List[str]`

  - `error_message: Optional[str]`

    Present only when failed. A safe, bounded description, for example SRT or speaker validation errors found after the video was processed.

  - `finished_at: Optional[datetime]`

  - `outputs: Optional[Dict[str, Outputs]]`

    Present only when completed, keyed by requested target language. URLs are signed on every read.

    - `audio: str`

    - `srt: str`

    - `video: str`

  - `reference_id: Optional[str]`

  - `source_language: Optional[str]`

    Explicit source language, or the detected one once processing starts.

  - `started_at: Optional[datetime]`

  - `webhook_url: Optional[str]`

    The configured terminal callback URL, when supplied.

### Example

```python
import os
from chamelaion import Chamelaion

client = Chamelaion(
    bearer_token=os.environ.get("CHAMELAION_BEARER_TOKEN"),  # This is the default and can be omitted
)
request = client.video_translate.requests.retrieve(
    "x",
)
print(request.id)
```

#### Response

```json
{
  "id": "4c98dd00-a982-47d9-a8d6-e1f0b35a8944",
  "reference_id": "customer-job-42",
  "source_language": "en",
  "target_languages": [
    "de",
    "fr"
  ],
  "disable_background_audio": false,
  "disable_lip_sync": false,
  "formality": false,
  "config": {
    "source_srt": {
      "file_name": "interview.srt",
      "language": "en",
      "supplied": true
    },
    "target_srts": {
      "de": {
        "file_name": "target-de.srt",
        "language": "de",
        "supplied": true
      }
    },
    "speaker_voices": {
      "0": "21m00Tcm4TlvDq8ikWAM",
      "1": "AZnzlk1XvdvUeBnXmlld"
    }
  },
  "status": "completed",
  "created_at": "2026-10-07T12:00:00Z",
  "started_at": "2026-10-07T12:00:01Z",
  "finished_at": "2026-10-07T12:04:00Z",
  "outputs": {
    "de": {
      "video": "https://storage.example/signed/de.mp4",
      "audio": "https://storage.example/signed/de.wav",
      "srt": "https://storage.example/signed/de.srt"
    },
    "fr": {
      "video": "https://storage.example/signed/fr.mp4",
      "audio": "https://storage.example/signed/fr.wav",
      "srt": "https://storage.example/signed/fr.srt"
    }
  }
}
```