Vertaling | transcript1 docs

transcript1 transcribeert de media eerst en vertaalt de transcripttekst daarna naar een taal naar keuze. De vertaling is per segment uitgelijnd en behoudt de originele tijdstempels en sprekers. Het is alleen tekstvertaling: geen nasynchronisatie en geen vertaalde audio.

Vertalen is gratis. Het kost 0 minuten en staat in je gebruiksgeschiedenis als gratis item "Translation". Transcriptieminuten gelden zoals altijd en een mislukte vertaling laat het transcript nooit mislukken en betaalt het niet terug.

Vertalen tijdens het transcriberen

Voeg translate_to toe aan het verzoek dat de transcriptie aanmaakt. Het is een ISO 639-1-code van twee kleine letters, zoals es of en. Het werkt met een videolink in de JSON-body van POST /v1/transcriptions, met de reservering van een upload in delen en met een multipart-upload in één stap.

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'

Bij een bestandsupload stuur je translate_to als formulierveld:

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -F [email protected] \
  -F translate_to=en

De MCP-tool transcribe accepteert translate_to ook. Eén doeltaal per verzoek.

Een bestaand transcript vertalen

Vraag een vertaling aan van een voltooide transcriptie:

curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "en"}'

De API antwoordt met 202:

{
  "transcription_id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
  "language": "en",
  "status": "processing"
}

Status	Betekenis
`404`	De transcriptie is niet gevonden.
`409 transcript_not_ready`	De transcriptie heeft nog niet de status `completed`.
`422`	De taal is geen geldige code van twee letters.

De aanroep is idempotent. Een vertaling met processing of completed komt ongewijzigd terug en een met failed wordt opnieuw geprobeerd. De MCP-tool translate_transcription neemt id en language.

De vertaling lezen

GET /v1/transcriptions/:id en de downloads als tekst, SRT en VTT accepteren translation:

`translation`	Resultaat
`both` (standaard)	JSON-segmenten krijgen een veld `translation`. De tekst zet de vertaalde regel onder het origineel. SRT- en VTT-blokken hebben twee regels: eerst het origineel, dan de vertaling.
`only`	De vertaalde tekst vervangt `text`. Tijdstempels en sprekers blijven gelijk.
`none`	Alleen het originele transcript.

Het antwoord bevat een object translation, of null als er geen vertaling is aangevraagd:

{
  "translation": { "language": "es", "status": "completed" }
}

status is processing, completed of failed. Een mislukte vertaling heeft ook een error-melding. wait wacht ook op een aangevraagde vertaling; als de wachttijd verloopt, is de status processing. De MCP-tool get_transcription heeft een parameter translation met dezelfde waarden.

Webhooks

Twee events melden het resultaat van een vertaling, naast transcription.completed en transcription.failed, die niet veranderen:

`type`	Verzonden wanneer
`transcription.translation.completed`	Een aangevraagde vertaling `completed` bereikte.
`transcription.translation.failed`	Een aangevraagde vertaling `failed` bereikte.

data is het transcriptieobject plus translation: { language, status, error }. Zie Webhooks voor handtekeningen en bezorgregels.