DokumentasiTerjemahan
Terjemahan
Terjemahkan transkrip ke bahasa lain saat transkripsi atau sesudahnya, lalu baca teks, SRT, dan VTT dua bahasa atau hanya terjemahan.
transcript1 mentranskripsi media lebih dulu, lalu menerjemahkan teks transkrip ke bahasa pilihan Anda. Terjemahan diselaraskan per segmen dan mempertahankan stempel waktu serta pembicara asli. Ini hanya terjemahan teks: tidak ada dubbing dan tidak ada audio terjemahan.
Terjemahan gratis. Terjemahan memakai 0 menit dan tampil di riwayat penggunaan Anda sebagai entri gratis "Translation". Menit transkripsi berlaku seperti biasa, dan terjemahan yang gagal tidak pernah menggagalkan atau mengembalikan transkrip.
Terjemahkan saat transkripsi
Tambahkan translate_to pada permintaan yang membuat transkripsi. Nilainya kode ISO 639-1 dua huruf kecil, misalnya es atau en. Ini berfungsi dengan tautan video di body JSON POST /v1/transcriptions, dengan reservasi unggahan bertahap, dan dengan unggahan multipart satu langkah.
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"}'Untuk unggahan file, kirim translate_to sebagai kolom formulir:
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-F [email protected] \
-F translate_to=enAlat MCP transcribe juga menerima translate_to. Satu bahasa tujuan per permintaan.
Terjemahkan transkrip yang sudah ada
Minta terjemahan untuk transkripsi yang sudah selesai:
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"}'API menjawab 202:
{
"transcription_id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
"language": "en",
"status": "processing"
}| Status | Arti |
|---|---|
404 | Transkripsi tidak ditemukan. |
409 transcript_not_ready | Transkripsi belum berstatus completed. |
422 | Bahasa bukan kode dua huruf yang valid. |
Panggilan ini idempoten. Terjemahan berstatus processing atau completed dikembalikan apa adanya, dan yang failed dicoba lagi. Alat MCP translate_transcription menerima id dan language.
Baca terjemahan
GET /v1/transcriptions/:id dan unduhan teks, SRT, dan VTT menerima translation:
translation | Hasil |
|---|---|
both (bawaan) | Segmen JSON mendapat kolom translation. Teks menaruh baris terjemahan di bawah baris asli. Blok SRT dan VTT berisi dua baris: teks asli, lalu terjemahan. |
only | Teks terjemahan menggantikan text. Stempel waktu dan pembicara tetap sama. |
none | Hanya transkrip asli. |
Respons memuat objek translation, atau null jika tidak ada terjemahan yang diminta:
{
"translation": { "language": "es", "status": "completed" }
}status bernilai processing, completed, atau failed. Terjemahan yang gagal juga memuat pesan error. wait turut menunggu terjemahan yang diminta; jika waktu habis, statusnya processing. Alat MCP get_transcription memiliki parameter translation dengan nilai yang sama.
Webhook
Dua event melaporkan hasil terjemahan, selain transcription.completed dan transcription.failed yang tidak berubah:
type | Dikirim saat |
|---|---|
transcription.translation.completed | Terjemahan yang diminta mencapai completed. |
transcription.translation.failed | Terjemahan yang diminta mencapai failed. |
data adalah objek transkripsi ditambah translation: { language, status, error }. Lihat Webhooks untuk tanda tangan dan aturan pengiriman.
Pembaruan terakhir 31 Oktober 2026