# Requests

## Get a video translation request

**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.

### Path Parameters

- `id: string`

### Returns

- `id: string`

- `config: object { source_srt, speaker_voices, target_srts, tts_model }`

  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 object { supplied, file_name, language }`

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

    - `supplied: true`

      - `true`

    - `file_name: optional string`

    - `language: optional string`

  - `speaker_voices: optional map[string]`

  - `target_srts: optional map[object { supplied, file_name, language } ]`

    - `supplied: true`

      - `true`

    - `file_name: optional string`

    - `language: optional string`

  - `tts_model: optional "eleven_v4" or "eleven_multilingual_v2"`

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

    - `"eleven_v4"`

    - `"eleven_multilingual_v2"`

- `created_at: string`

- `disable_background_audio: boolean`

  Whether background audio was disabled for this request.

- `disable_lip_sync: boolean`

  Whether lip sync was disabled for this request.

- `formality: boolean`

- `model: "expressive" or "classic"`

  Product speech model selected for the request.

  - `"expressive"`

  - `"classic"`

- `status: "queued" or "uploading" or "processing" or 2 more`

  - `"queued"`

  - `"uploading"`

  - `"processing"`

  - `"completed"`

  - `"failed"`

- `target_languages: array of string`

- `error_message: optional string`

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

- `finished_at: optional string`

- `outputs: optional map[object { audio, srt, video } ]`

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

  - `audio: string`

  - `srt: string`

  - `video: string`

- `reference_id: optional string`

- `source_language: optional string`

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

- `started_at: optional string`

- `webhook_url: optional string`

  The configured terminal callback URL, when supplied.

### Example

```http
curl https://api.chamelaion.com/api/v1/video-translate/requests/$ID \
    -H "Authorization: Bearer $CHAMELAION_BEARER_TOKEN"
```

#### 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"
    }
  }
}
```

## List video translation requests

**get** `/v1/video-translate/requests`

Returns the authenticated account's requests, newest first (`created_at` descending, then `id` descending), always paginated. `pagination.total` counts every request matching the filters. Responses use the same shape as `GET /v1/video-translate/requests/{id}`.

### Query Parameters

- `created_from: optional string`

  Inclusive lower bound on `created_at` (RFC 3339). Must not be after `created_to`.

- `created_to: optional string`

  Inclusive upper bound on `created_at` (RFC 3339).

- `limit: optional number`

  Page size. Non-integers and values below 1 are rejected with 400; values above 100 are clamped to 100.

- `offset: optional number`

  Number of items to skip. Non-integers and negative values are rejected with 400.

- `reference_id: optional string`

  Filter requests by exact `reference_id`.

- `source_language: optional string`

  Filter by the explicit or detected source language (supported language code).

- `status: optional "queued" or "uploading" or "processing" or 2 more`

  Filter by request status.

  - `"queued"`

  - `"uploading"`

  - `"processing"`

  - `"completed"`

  - `"failed"`

- `target_language: optional string`

  Return requests whose `target_languages` contain this supported language code.

### Returns

- `data: array of object { id, config, created_at, 13 more }`

  - `id: string`

  - `config: object { source_srt, speaker_voices, target_srts, tts_model }`

    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 object { supplied, file_name, language }`

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

      - `supplied: true`

        - `true`

      - `file_name: optional string`

      - `language: optional string`

    - `speaker_voices: optional map[string]`

    - `target_srts: optional map[object { supplied, file_name, language } ]`

      - `supplied: true`

        - `true`

      - `file_name: optional string`

      - `language: optional string`

    - `tts_model: optional "eleven_v4" or "eleven_multilingual_v2"`

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

      - `"eleven_v4"`

      - `"eleven_multilingual_v2"`

  - `created_at: string`

  - `disable_background_audio: boolean`

    Whether background audio was disabled for this request.

  - `disable_lip_sync: boolean`

    Whether lip sync was disabled for this request.

  - `formality: boolean`

  - `model: "expressive" or "classic"`

    Product speech model selected for the request.

    - `"expressive"`

    - `"classic"`

  - `status: "queued" or "uploading" or "processing" or 2 more`

    - `"queued"`

    - `"uploading"`

    - `"processing"`

    - `"completed"`

    - `"failed"`

  - `target_languages: array of string`

  - `error_message: optional string`

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

  - `finished_at: optional string`

  - `outputs: optional map[object { audio, srt, video } ]`

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

    - `audio: string`

    - `srt: string`

    - `video: string`

  - `reference_id: optional string`

  - `source_language: optional string`

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

  - `started_at: optional string`

  - `webhook_url: optional string`

    The configured terminal callback URL, when supplied.

- `pagination: object { limit, offset, total }`

  - `limit: number`

    Applied page size.

  - `offset: number`

    Applied result offset.

  - `total: number`

    Total number of matching records.

### Example

```http
curl https://api.chamelaion.com/api/v1/video-translate/requests \
    -H "Authorization: Bearer $CHAMELAION_BEARER_TOKEN"
```

#### Response

```json
{
  "data": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "config": {
        "source_srt": {
          "supplied": true,
          "file_name": "file_name",
          "language": "language"
        },
        "speaker_voices": {
          "foo": "string"
        },
        "target_srts": {
          "foo": {
            "supplied": true,
            "file_name": "file_name",
            "language": "language"
          }
        },
        "tts_model": "eleven_v4"
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "disable_background_audio": true,
      "disable_lip_sync": true,
      "formality": true,
      "model": "expressive",
      "status": "queued",
      "target_languages": [
        "string"
      ],
      "error_message": "error_message",
      "finished_at": "2019-12-27T18:11:19.117Z",
      "outputs": {
        "foo": {
          "audio": "https://example.com",
          "srt": "https://example.com",
          "video": "https://example.com"
        }
      },
      "reference_id": "reference_id",
      "source_language": "source_language",
      "started_at": "2019-12-27T18:11:19.117Z",
      "webhook_url": "https://example.com"
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 0,
    "total": 0
  }
}
```

## Domain Types

### Request Retrieve Response

- `RequestRetrieveResponse object { id, config, created_at, 13 more }`

  - `id: string`

  - `config: object { source_srt, speaker_voices, target_srts, tts_model }`

    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 object { supplied, file_name, language }`

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

      - `supplied: true`

        - `true`

      - `file_name: optional string`

      - `language: optional string`

    - `speaker_voices: optional map[string]`

    - `target_srts: optional map[object { supplied, file_name, language } ]`

      - `supplied: true`

        - `true`

      - `file_name: optional string`

      - `language: optional string`

    - `tts_model: optional "eleven_v4" or "eleven_multilingual_v2"`

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

      - `"eleven_v4"`

      - `"eleven_multilingual_v2"`

  - `created_at: string`

  - `disable_background_audio: boolean`

    Whether background audio was disabled for this request.

  - `disable_lip_sync: boolean`

    Whether lip sync was disabled for this request.

  - `formality: boolean`

  - `model: "expressive" or "classic"`

    Product speech model selected for the request.

    - `"expressive"`

    - `"classic"`

  - `status: "queued" or "uploading" or "processing" or 2 more`

    - `"queued"`

    - `"uploading"`

    - `"processing"`

    - `"completed"`

    - `"failed"`

  - `target_languages: array of string`

  - `error_message: optional string`

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

  - `finished_at: optional string`

  - `outputs: optional map[object { audio, srt, video } ]`

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

    - `audio: string`

    - `srt: string`

    - `video: string`

  - `reference_id: optional string`

  - `source_language: optional string`

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

  - `started_at: optional string`

  - `webhook_url: optional string`

    The configured terminal callback URL, when supplied.

### Request List Response

- `RequestListResponse object { data, pagination }`

  - `data: array of object { id, config, created_at, 13 more }`

    - `id: string`

    - `config: object { source_srt, speaker_voices, target_srts, tts_model }`

      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 object { supplied, file_name, language }`

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

        - `supplied: true`

          - `true`

        - `file_name: optional string`

        - `language: optional string`

      - `speaker_voices: optional map[string]`

      - `target_srts: optional map[object { supplied, file_name, language } ]`

        - `supplied: true`

          - `true`

        - `file_name: optional string`

        - `language: optional string`

      - `tts_model: optional "eleven_v4" or "eleven_multilingual_v2"`

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

        - `"eleven_v4"`

        - `"eleven_multilingual_v2"`

    - `created_at: string`

    - `disable_background_audio: boolean`

      Whether background audio was disabled for this request.

    - `disable_lip_sync: boolean`

      Whether lip sync was disabled for this request.

    - `formality: boolean`

    - `model: "expressive" or "classic"`

      Product speech model selected for the request.

      - `"expressive"`

      - `"classic"`

    - `status: "queued" or "uploading" or "processing" or 2 more`

      - `"queued"`

      - `"uploading"`

      - `"processing"`

      - `"completed"`

      - `"failed"`

    - `target_languages: array of string`

    - `error_message: optional string`

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

    - `finished_at: optional string`

    - `outputs: optional map[object { audio, srt, video } ]`

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

      - `audio: string`

      - `srt: string`

      - `video: string`

    - `reference_id: optional string`

    - `source_language: optional string`

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

    - `started_at: optional string`

    - `webhook_url: optional string`

      The configured terminal callback URL, when supplied.

  - `pagination: object { limit, offset, total }`

    - `limit: number`

      Applied page size.

    - `offset: number`

      Applied result offset.

    - `total: number`

      Total number of matching records.