v31

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-28124212862.9 KB
Translate Captions

Create a 'translate-captions' job

Creates a new job that translates captions on a Mux Video asset from one language to another.

post/robots/v0/jobs/translate-captions

Request body

passthroughstring

Arbitrary string stored with the job and returned in responses. Useful for correlating jobs with your own systems.

Example request

{
  "parameters": {
    "asset_id": "mux_asset_123abc",
    "track_id": "track_en_abc123",
    "to_language_code": "es",
    "upload_to_mux": true
  }
}

Response

Caption translation job queued

Example response

{
  "data": {
    "parameters": {
      "asset_id": "mux_asset_123abc",
      "track_id": "track_en_abc123",
      "to_language_code": "es",
      "upload_to_mux": true
    },
    "outputs": {
      "track_id": "track_en_abc123",
      "uploaded_track_id": "track_es_abc123",
      "temporary_vtt_url": "https://storage.example.com/translations/es/captions.vtt?token=abc123"
    },
    "resources": {
      "assets": [
        {
          "id": "abc123asset",
          "meta": {
            "title": "My Video",
            "creator_id": "user123",
            "external_id": "ext456"
          },
          "_links": {
            "self": {
              "href": "https://api.mux.com/video/v1/assets/abc123asset"
            }
          }
        }
      ]
    }
  }
}