Dokumentasi pengembang

Weydub API untuk lokalisasi media, pengembang, dan agen otomatisasi.

Mulai dengan satu permintaan bertanda tangan, lalu lanjutkan ke alur kerja produksi untuk penghapusan subtitle dan teks, penerjemahan video, ekstraksi subtitle, penerjemahan gambar, callback, dan otomatisasi. Pengguna Weydub yang sudah masuk dapat membuka akses API gratis dari Akun Saya.

Buka Akses API Gratis Kelola Kunci API Jalankan Permintaan Pertama Buka Referensi API Salin Dokumentasi Markdown Buka Keahlian Agen

Mulai Seperti Platform Pengembang

Dapatkan kredensial, lakukan satu panggilan bertanda tangan, periksa status, lalu pilih halaman alur kerja. Langkah ini menjaga jalur pengguna tetap cepat sekaligus memberi agen struktur yang cukup untuk membangun dengan aman.

Dapatkan aksesMasuk, buka akses API gratis dari Akun Saya, dan konfirmasikan izin alur kerja untuk akun Anda.
Baca referensiPeriksa endpoint, bentuk permintaan, bidang status, dan catatan pemecahan masalah.
Jalankan panduan cepatBuat satu tugas demo dengan variabel lingkungan dan penandatanganan JSON ringkas.
Verifikasi hasilLakukan polling status atau terima callback, lalu simpan URL keluaran dan kesalahan.

Alur Kerja Utama

Beranda API berpusat pada empat pekerjaan produksi: membersihkan teks dari video, menerjemahkan video, mengekstrak file subtitle, dan menerjemahkan gambar.

Hapus Subtitle dan Teks

Bersihkan subtitle tertanam, caption, watermark, lower third, logo, petunjuk alur, nomor registrasi, dan teks yang terlihat.

Endpoint: /v-w-c/gateway/ve/work/free
Dasar: needChineseOcclude: 1|2|3
Lite/Pro: advanced_lite, advanced_large_box, advanced_full
Mask: videoInpaintMasks
CRF: extraOptions.write_options.crf jika diaktifkan

Baca dokumentasi API Coba penghapusan online

Terjemahkan Video

Buat subtitle terjemahan, dubbing AI opsional, dan aset video terlokalisasi yang telah dirender.

Endpoint: /v-w-c/gateway/ve/work/free
Dubbing : needWanyin: 1, wyTaskType: FULL
Teks dalam frame: needChineseOcclude: 11
Emosi tinggi: /voice/incorporate

Baca dokumentasi API Coba penerjemahan video

Ekstrak Subtitle

Hasilkan SRT/VTT dari subtitle yang terlihat dengan OCR atau dialog lisan dengan ASR.

OCR: needChineseOcclude: 14
Mask OCR: type: trans_only_ocr
ASR: wyTaskType: ONLY_ASR, wyNeedText: 0

Baca dokumentasi API Coba pembuatan subtitle

Terjemahkan Gambar

Lokalisasikan gambar produk, tangkapan layar, panel komik, tangkapan UI aplikasi, dan aset kreatif.

Endpoint: /v-w-c/gateway/ve/image/translate
Terjemahkan: translateOn: 1, synthesisOn: 1
Hapus teks: translateOn: 0, synthesisOn: 1

Baca dokumentasi API Coba penerjemahan gambar

Coba di Weydub Terlebih Dahulu

Saat pengguna ingin melihat kualitas keluaran sebelum implementasi, arahkan mereka ke alur kerja Weydub yang sesuai. Dokumentasi API tetap menjadi rujukan untuk otomatisasi, penandatanganan, callback, dan perilaku produksi.

Hapus subtitle onlineValidasikan pembersihan subtitle dan teks di aplikasi web. Terjemahkan videoPeriksa subtitle, dubbing, dan keluaran video terlokalisasi. Hasilkan subtitleUji ekstraksi subtitle dengan OCR atau ucapan secara visual. Terjemahkan gambarCoba OCR, penghapusan, terjemahan, dan sintesis tata letak.

Aturan Produksi

Aturan ini dicantumkan di halaman API agar pengembang dan agen dapat menggunakan dokumentasi Weydub lokal selama implementasi.

Batas videoBatas tetap saat ini adalah 15 menit dan 1000 MB per file video. Bagi atau kompres sebelum mengirim.

Batas gambarMaksimal 2000*2000 px dan 50 MB. Format yang didukung: png, jpeg, jpg, bmp, webp. URL tidak boleh berisi karakter Tionghoa.

PenagihanAlur kerja video ditagihkan dalam satuan 30 detik. Layanan gabungan dapat menambah biaya. Tugas yang akhirnya gagal mengurangi nol kredit.

CallbackVerifikasi Callback-Sign. Kembalikan HTTP 200 dengan isi yang tidak kosong setelah penyimpanan persisten. Callback yang gagal dicoba ulang selama 24 jam, kira-kira setiap 30 menit.

Dua Audiens

Dokumentasi ini ditujukan bagi pengguna alat pemrograman AI dan agen otomatisasi yang membutuhkan kontrak ringkas serta andal.

Pengembang yang menggunakan alat pemrograman AI Baca ringkasan, salin Markdown ke asisten IDE, jalankan skenario demo, lalu masukkan kredensial melalui variabel lingkungan.

Agen otomatisasi dan bot internal Muat referensi dan keahlian agen, buat tugas asinkron, simpan ID pekerjaan, tangani callback secara idempoten, dan jangan pernah mengekspos AppSecret.

Baca Berurutan

Baca lima tutorial inti terlebih dahulu. Gunakan file agen saat alat pemrograman AI atau bot internal melakukan implementasi.

Panduan cepatAlur Python minimal untuk membuat dan melakukan polling tugas penghapusan teks. Autentikasi dan PenandatangananAppKey, AppSign, dan konvensi tanda tangan MD5 ganda. Penghapusan SubtitleBasic, Advanced Lite/Pro, mask, CRF, dan payload penghapusan. Penerjemahan VideoTerjemahan subtitle, dubbing, terjemahan teks di layar, dan mode suara. Ekstraksi SubtitleEkstraksi subtitle OCR dan ASR dengan penanganan tugas asinkron. Referensi APIIndeks endpoint, bentuk permintaan, bidang status, dan pemecahan masalah. Referensi LLMFile orientasi singkat untuk asisten pemrograman dan bot. Keahlian API WeydubInstruksi yang dapat digunakan kembali untuk Codex, Cursor, Claude Code, dan agen internal.

Jalur Integrasi

Gunakan ini sebagai daftar periksa implementasi untuk skrip, layanan backend, jembatan tanpa kode, pekerja antrean, dan klien hasil AI.

Akses gratisBuka akses API dari Akun Saya, lalu konfirmasikan hak akun untuk alur kerja target.
Simpan rahasiaGunakan WEYDUB_APP_KEY dan WEYDUB_APP_SECRET atau pengelola rahasia.
Tandatangani dengan tepatJSON ringkas, tanda tangan MD5 ganda, lalu kirim byte isi yang sama.
Buat tugasKirim URL media dan simpan ID proyek/pekerjaan/tugas yang dikembalikan.
Tunggu dengan amanGunakan callback dalam produksi dan polling sebagai cadangan.
Simpan hasilSimpan URL keluaran, tautan SRT, aset gambar, status, dan kesalahan.
Jalankan demoVerifikasi dengan aset resmi sebelum menghubungkan media pelanggan.
Lindungi penggunaBuat percobaan ulang idempoten dan jangan pernah membocorkan AppSecret.

Bentuk Panggilan Minimum

Gunakan variabel lingkungan untuk kredensial. Jangan pernah menyimpan AppSecret dalam kode frontend, repositori publik, tangkapan layar, log, atau prompt yang mungkin disimpan.

POST https://api.zhaoli.com/v-w-c/gateway/ve/work/free
Headers:
  Content-Type: application/json
  AppKey: $WEYDUB_APP_KEY
  AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)

Body:
{
  "urls": ["https://example.com/demo.mp4"],
  "needChineseOcclude": 1,
  "videoInpaintLang": "all"
}

Skenario Demo

Gunakan aset publik ini untuk memverifikasi integrasi API sebelum menghubungkan media pelanggan. Aset ini mencakup alur kerja yang paling sering dipanggil bot dan alat pemrograman.

Skenario 1

Penghapusan teks tingkat lanjut

Kirim video berbahasa Inggris dengan subtitle permanen menggunakan model layar penuh Advanced Pro.

Skenario 2

Penerjemahan video

Terjemahkan video demo berbahasa Inggris ke bahasa Spanyol dengan subtitle dan dubbing AI.

Skenario 3

Kloning emosi tinggi

Gunakan video Tionghoa dan JSON pasangannya untuk dubbing drama pendek dari bahasa Tionghoa ke Inggris.

Video berbahasa Inggris: http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing _Eng.mp4
Video berbahasa Mandarin: http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing _cn2en.mp4
JSON berbahasa Mandarin: http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing _cn2en.json

Salin sebagai Markdown

Blok ini mencerminkan ringkasan dalam index.md, sehingga pengguna dapat menempelkannya ke sesi pemrograman AI dan agen dapat menguraikannya sebagai Markdown biasa.

Ringkasan API Weydub Markdown, siap untuk alat pemrograman dan agen otomatisasi.

# Dokumentasi API Weydub

Weydub API adalah pintu masuk pengembang bagi tim, alat pemrograman AI, dan agen otomatisasi yang membutuhkan lokalisasi media tanpa harus memiliki infrastruktur OCR, ASR, inpainting, terjemahan, dubbing, atau rendering. Pengguna Weydub yang sudah masuk dapat membuka akses API gratis dari Akun Saya.

## Alur Kerja Utama

| Alur kerja | Gunakan Untuk | Endpoint Utama | Bidang Kunci |
| --- | --- | --- | --- |
| Hapus subtitle dan teks di layar | Bersihkan subtitle, watermark, lower third, logo, petunjuk alur, nomor registrasi, dan teks terlihat lainnya dari video. | `POST /v-w-c/gateway/ve/work/free` | `needChineseOcclude`, `videoInpaintLang`, `videoInpaintMasks`, `extraOptions.extra_inpaint_config` |
| Terjemahkan video | Hasilkan subtitle sumber, terjemahkan dialog, lakukan dubbing dengan suara AI bila perlu, terjemahkan teks terlihat, dan render aset video terlokalisasi. | `POST /v-w-c/gateway/ve/work/free` | `needWanyin`, `sourceLang`, `lang`, `wyTaskType`, `wyNeedText`, `wyVoiceParam` |
| Ekstrak subtitle | Buat file SRT/VTT dari subtitle terlihat dengan OCR atau audio lisan dengan ASR. | `POST /v-w-c/gateway/ve/work/free` | OCR: `needChineseOcclude: 14`; ASR: `wyTaskType: "ONLY_ASR"` |
| Terjemahkan gambar | Terjemahkan atau hapus teks di dalam gambar produk, tangkapan layar, komik, tangkapan UI aplikasi, dan materi pemasaran. | `POST /v-w-c/gateway/ve/image/translate` | `srcLang`, `tgtLang`, `translateOn`, `synthesisOn`, `downloadInfo` |

## Sinyal Alur Kerja

- Penghapusan video: layar penuh Basic `needChineseOcclude: 1`; wilayah Basic `needChineseOcclude: 2`; teks bergerak `needChineseOcclude: 3`; Advanced Lite `advanced_lite`; kotak pembatas Advanced Pro `advanced_large_box`; layar penuh Advanced Pro `advanced_full`; penggantian CRF melalui `extraOptions.write_options.crf` jika diaktifkan.
- Penerjemahan video: dubbing penuh `needWanyin: 1`, `wyTaskType: "FULL"`, `wyNeedText: 1`; terjemahan teks di layar `needWanyin: 0`, `needChineseOcclude: 11`; dubbing emosi tinggi `/v-w-c/gateway/ve/work/voice/incorporate`.
- Ekstraksi subtitle OCR: `needChineseOcclude: 14`, `videoInpaintMasks` dengan `type: "trans_only_ocr"`, pembersihan OCR opsional di `extraOptions.extra_inpaint_config`.
- Ekstraksi subtitle ASR: `needWanyin: 1`, `wyTaskType: "ONLY_ASR"`, `needWyEdit: 0`, `wyNeedText: 0`, `asr_speaker_detect_on` opsional.
- Penerjemahan gambar: `translateOn: 1`, `synthesisOn: 1`.
- Penghapusan teks gambar: `translateOn: 0`, `synthesisOn: 1`.
- Pengulangan gambar: `POST /v-w-c/gateway/ve/image/translate/redo`; edit hanya bidang terjemahan/warna/ukuran font kecuali dukungan mengonfirmasi sebaliknya.

## Coba di Weydub Terlebih Dahulu

- Hapus subtitle online: https://id.weydub.com/subtitle-removal/
- Terjemahkan video: https://id.weydub.com/video-translator/
- Hasilkan subtitle: https://id.weydub.com/subtitle-generator/
- Terjemahkan gambar: https://id.weydub.com/image-translator/

## Baca Berurutan

1. Panduan cepat: https://id.weydub.com/docs/api/quickstart.md
2. Autentikasi dan penandatanganan: https://id.weydub.com/docs/api/auth-and-signing.md
3. Penghapusan subtitle: https://id.weydub.com/docs/api/video-subtitle-removal.md
4. Penerjemahan video: https://id.weydub.com/docs/api/video-translation.md
5. Ekstraksi subtitle: https://id.weydub.com/docs/api/subtitle-extraction.md
6. Keahlian API Weydub: https://id.weydub.com/docs/api/weydub-api-skill.md
7. Referensi API: https://id.weydub.com/docs/api/api-reference.md

## Dasar-Dasar API

- URL dasar: `https://api.zhaoli.com`
- Header autentikasi: `AppKey`, `AppSign`
- Tanda tangan: `AppSign = md5(md5(request_body) + AppSecret)`
- Endpoint enum tanpa tanda tangan: `POST /v-w-c/enum/query2`
- Sebagian besar pekerjaan media bersifat asinkron.
- Buka akses API gratis dari Akun Saya; konfirmasikan API gambar, penghapusan Advanced Lite/Pro, dubbing emosi tinggi, dan batas batch sebelum produksi.
- Gunakan callback dalam produksi dan polling sebagai cadangan.
- Verifikasi header callback `Callback-Sign`.
- Simpan `AppSecret` hanya di sisi server.

## Batas dan Retensi

- Batas tetap video: 15 menit per file.
- Batas tetap video: 1000 MB per file.
- Batas tetap gambar: `2000*2000 px`, `50 MB`.
- Format gambar: `png`, `jpeg`, `jpg`, `bmp`, `webp`.
- URL gambar tidak boleh berisi karakter Tionghoa.
- Satuan penagihan video: 30 detik.
- Tugas yang akhirnya gagal (`processStatus > 1`) mengurangi nol kredit.
- Retensi default menyimpan aset sumber/hasil render selama 30 hari terakhir. Simpan URL/aset hasil setelah callback.

## Aturan Operasional Agen

- Jangan menebak kredensial, ketersediaan endpoint, atau hak akun.
- Jangan pernah menaruh `AppSecret` dalam kode frontend, ekstensi browser, repositori publik, log, tangkapan layar, atau prompt yang disimpan.
- Tandatangani isi JSON ringkas persis seperti yang akan dikirim melalui jaringan.
- Pertahankan opsi bertingkat seperti `extraOptions`, `wyVoiceParam`, `videoInpaintMasks`, `downloadInfo`, `downloadInfos`, dan `result` redo sesuai bentuk yang ditentukan setiap halaman alur kerja.
- Simpan ID proyek, ID pekerjaan, ID tugas gambar, URL sumber, status, detail kesalahan, dan URL hasil dalam tabel pekerjaan Anda sendiri.
- Gunakan aset demo publik sebelum menghubungkan media pelanggan.

Untuk Alat Pemrograman AI

Berikan asisten Anda Panduan cepat, Autentikasi, Penghapusan Subtitle, Penerjemahan Video, Ekstraksi Subtitle, dan Keahlian API Weydub. Lalu berikan kredensial hanya melalui variabel lingkungan. Inilah jalur yang ditujukan untuk Codex, Cursor, Claude Code, bot internal, dan agen otomatisasi.

Baca Keahlian Agen Buka Referensi API Buka llms.txt Markdown Mentah Keahlian Buka Ringkasan Markdown

Bantuan dan Tutorial

Halaman API lokal adalah sumber kebenaran implementasi. Untuk bantuan alur kerja produk, gunakan pusat bantuan Weydub lokal.

Bantuan Weydub Kredit dan aturan penagihan Unduhan batch Panduan Weydub Studio