Referensi API

Referensi ini menyediakan satu tempat ringkas bagi pengembang dan agen otomatisasi untuk menemukan endpoint Weydub API, pemeriksaan akses, struktur permintaan, perilaku asinkron, aturan penagihan/retensi, dan indikator pemecahan masalah.

Dasar-Dasar Permintaan

Beberapa nama infrastruktur lama mungkin masih muncul dalam aset demo publik atau jalur akun lama. Perlakukan dokumentasi Weydub API ini sebagai kontrak produk yang berlaku saat ini.

Sebelum Melakukan Panggilan

Autentikasi

Sebagian besar permintaan menggunakan header:

Content-Type: application/json
AppKey: $WEYDUB_APP_KEY
AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)

Tandatangani isi JSON ringkas persis seperti yang akan dikirim. Baca Autentikasi dan penandatanganan sebelum menelusuri kegagalan tanda tangan.

Pengecualian tanpa tanda tangan:

POST /v-w-c/enum/query2

Endpoint kueri enum digunakan untuk daftar bahasa/status dinamis dan tidak memerlukan penandatanganan.

Indeks Endpoint

Membuat Tugas Video

POST /v-w-c/gateway/ve/work/free

Alur kerja umum yang menggunakan endpoint ini:

Permintaan minimal:

{
  "urls": ["https://example.com/demo.mp4"],
  "needChineseOcclude": 1,
  "videoInpaintLang": "all",
  "callback": "https://your-domain.example/webhooks/weydub"
}

Kolom yang umum dalam respons pembuatan:

Kueri Status Video

POST /v-w-c/gateway/ve/work/status

{
  "idWorks": [488026661]
}

Nilai status:

Tugas video yang berhasil dapat menyertakan videoUrl, coverUrl, srcSrtUrl, tgtSrtUrl, sourceVideoUrl, ttsMetaResult, wyVoiceParam, dan metadata tugas.

Tugas Gambar

Endpoint pembuatan publik saat ini:

POST /v-w-c/gateway/ve/image/translate

Endpoint pengerjaan ulang:

POST /v-w-c/gateway/ve/image/translate/redo

Permintaan penerjemahan gambar:

{
  "srcLang": "en",
  "tgtLang": "es",
  "translateOn": 1,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/product.png\",\"fileName\":\"product.png\",\"id\":12345,\"materialName\":\"product.png\"}",
  "app": "WD"
}

Permintaan penghapusan teks gambar:

{
  "srcLang": "en",
  "tgtLang": "en",
  "translateOn": 0,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/banner.png\",\"fileName\":\"banner.png\",\"id\":12346,\"materialName\":\"banner.png\"}",
  "app": "WD"
}

Baca Penerjemahan gambar sebelum mengimplementasikan tugas gambar karena downloadInfo, downloadInfos, dan result untuk pengerjaan ulang harus mempertahankan format string yang didokumentasikan.

Kueri Enum

POST /v-w-c/enum/query2

Endpoint ini tidak memerlukan AppSign.

{
  "text": "Lang"
}

Nama enum yang umum:

Penagihan, Batas, dan Retensi

Ringkasan callback

Sertakan URL callback dalam permintaan pembuatan jika didukung. Weydub mengirimkan item pekerjaan yang telah selesai langsung ke server Anda, tanpa pembungkus luar code / msg / body yang digunakan oleh respons polling.

Aturan penanganan callback:

• Verifikasi Callback-Sign menggunakan body mentah permintaan callback dan AppSecret Anda.
• Kembalikan HTTP 200 beserta body apa pun yang tidak kosong hanya setelah penyimpanan persisten berhasil.
• Buat handler idempoten berdasarkan ID pekerjaan/tugas.
• Callback yang gagal untuk tugas yang dibuat dalam 24 jam terakhir dicoba ulang kira-kira setiap 30 menit.
• Jika proses ulang mengubah konten video atau gambar, URL output dapat berubah; simpan URL hasil terbaru.

Baca Model tugas asinkron untuk mengetahui detail callback.

Pemecahan masalah

Kontrak Agen

Agen otomasi harus:

• Muat llms.txt dan Weydub API Keahlian.
• Gunakan Skenario demo sebelum menggunakan media pelanggan.
• Simpan kredensial dalam variabel lingkungan atau pengelola rahasia.
• Simpan ID secara persisten sebelum melaporkan keberhasilan kepada pengguna.
• Modelkan pekerjaan sebagai submitted -> processing -> succeeded | failed | timed_out.
• Jangan pernah mengekspos AppSecret atau mengada-adakan endpoint yang aktif.