Tài liệu dành cho nhà phát triển
API Weydub dành cho bản địa hóa nội dung đa phương tiện, nhà phát triển và tác nhân tự động hóa.
Bắt đầu bằng một yêu cầu đã ký, sau đó chuyển sang các quy trình vận hành thực tế để xóa phụ đề và chữ, dịch video, trích xuất phụ đề, dịch hình ảnh, xử lý callback và tự động hóa. Người dùng Weydub đã đăng nhập có thể mở quyền truy cập API miễn phí trong mục Tài khoản của tôi.
Bắt đầu với hướng dẫn nhanh dành cho nhà phát triển
Lấy thông tin xác thực, thực hiện một lệnh gọi có chữ ký, kiểm tra trạng thái rồi chọn trang quy trình làm việc. Cách này giúp nhà phát triển thao tác nhanh, đồng thời cung cấp đủ cấu trúc để tác nhân triển khai an toàn.
- Nhận quyền truy cậpĐăng nhập, mở quyền truy cập API miễn phí trong Tài khoản của tôi và xác nhận tài khoản có quyền dùng các quy trình cần thiết.
- Đọc tài liệu tham chiếuKiểm tra endpoint, cấu trúc yêu cầu, trường trạng thái và ghi chú khắc phục sự cố.
- Chạy hướng dẫn nhanhTạo một tác vụ demo bằng biến môi trường và ký JSON ở dạng rút gọn.
- Xác minh kết quảThăm dò trạng thái hoặc nhận callback, sau đó lưu trữ lâu dài các URL đầu ra và thông tin lỗi.
Các quy trình cốt lõi
Trang chủ API tập trung vào bốn tác vụ dùng trong môi trường sản xuất: xóa chữ khỏi video, dịch video, trích xuất tệp phụ đề và dịch hình ảnh.
Xóa phụ đề và chữ
Xóa phụ đề được chèn cứng vào video, chú thích, hình mờ, dải chữ ở phần dưới khung hình, logo, gợi ý cốt truyện, số đăng ký và các chữ hiển thị khác.
- Endpoint:
/v-w-c/gateway/ve/work/free - Cơ bản:
needChineseOcclude: 1|2|3 - Lite/Pro:
advanced_lite,advanced_large_box,advanced_full - Mặt nạ:
videoInpaintMasks - CRF:
extraOptions.write_options.crfkhi được bật
Dịch video
Tạo phụ đề đã dịch, tùy chọn lồng tiếng bằng AI và kết xuất nội dung video đã bản địa hóa.
- Endpoint:
/v-w-c/gateway/ve/work/free - Lồng tiếng:
needWanyin: 1,wyTaskType: FULL - Chữ trong khung hình:
needChineseOcclude: 11 - Giàu cảm xúc:
/voice/incorporate
Trích xuất phụ đề
Tạo SRT/VTT từ phụ đề hiển thị bằng OCR hoặc từ lời thoại bằng ASR.
- OCR:
needChineseOcclude: 14 - Mặt nạ OCR:
type: trans_only_ocr - ASR:
wyTaskType: ONLY_ASR,wyNeedText: 0
Dịch hình ảnh
Bản địa hóa hình ảnh sản phẩm, ảnh chụp màn hình, khung truyện tranh, ảnh chụp giao diện ứng dụng và nội dung sáng tạo.
- Endpoint:
/v-w-c/gateway/ve/image/translate - Dịch:
translateOn: 1,synthesisOn: 1 - Xóa chữ:
translateOn: 0,synthesisOn: 1
Thử trên Weydub trước
Khi người dùng muốn xem chất lượng đầu ra trước khi triển khai, hãy đưa họ đến quy trình Weydub tương ứng. Tài liệu API tại đây dành cho tự động hóa, ký yêu cầu, callback và hành vi trong môi trường sản xuất.
Quy tắc vận hành
Các quy tắc này được đưa vào các trang API để nhà phát triển và tác nhân có thể triển khai dựa trên tài liệu Weydub cục bộ.
Hai nhóm người dùng
Tài liệu này dành cho người dùng công cụ lập trình AI và các tác nhân tự động hóa cần một đặc tả ngắn gọn, đáng tin cậy.
Đọc theo thứ tự
Đọc năm hướng dẫn cốt lõi trước. Dùng các tệp dành cho tác nhân khi công cụ lập trình AI hoặc bot nội bộ thực hiện việc triển khai.
Lộ trình tích hợp
Dùng phần này làm danh sách kiểm tra triển khai cho tập lệnh, dịch vụ backend, cầu nối no-code, trình xử lý hàng đợi và ứng dụng khách do AI tạo.
- Truy cập miễn phíMở quyền truy cập API trong Tài khoản của tôi, sau đó xác nhận tài khoản có quyền dùng quy trình mục tiêu.
- Lưu trữ thông tin bí mậtDùng
WEYDUB_APP_KEYvàWEYDUB_APP_SECREThoặc trình quản lý thông tin bí mật. - Ký chính xácRút gọn JSON, tạo chữ ký MD5 kép rồi gửi đúng chuỗi byte của phần nội dung đó.
- Tạo tác vụGửi các URL nội dung đa phương tiện và lưu trữ lâu dài các ID dự án, công việc và tác vụ được trả về.
- Chờ an toànDùng callback trong môi trường sản xuất và thăm dò làm phương án dự phòng.
- Lưu kết quảLưu trữ lâu dài các URL đầu ra, liên kết SRT, nội dung hình ảnh, trạng thái và thông tin lỗi.
- Chạy bản demoXác minh bằng nội dung chính thức trước khi kết nối nội dung đa phương tiện của khách hàng.
- Bảo vệ người dùngĐảm bảo các lần thử lại có tính lũy đẳng và tuyệt đối không để lộ AppSecret.
Cấu trúc lệnh gọi tối thiểu
Dùng biến môi trường cho thông tin xác thực. Tuyệt đối không lưu AppSecret trong mã frontend, kho lưu trữ công khai, ảnh chụp màn hình, nhật ký hoặc prompt có thể được lưu giữ.
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"
}
Kịch bản demo
Dùng các nội dung công khai này để xác minh tích hợp API trước khi kết nối nội dung đa phương tiện của khách hàng. Chúng bao quát những quy trình mà Weydub dự kiến bot và công cụ lập trình sẽ gọi thường xuyên nhất.
Xóa chữ nâng cao
Gửi video tiếng Anh có phụ đề được chèn cứng để xử lý bằng mô hình toàn màn hình Advanced Pro.
Kịch bản 2Dịch video
Dịch video demo tiếng Anh sang tiếng Tây Ban Nha, kèm phụ đề và lồng tiếng bằng AI.
Kịch bản 3Nhân bản giọng nói giàu cảm xúc
Dùng video tiếng Trung và JSON đi kèm để lồng tiếng phim ngắn nhiều tập từ tiếng Trung sang tiếng Anh.
- Video tiếng Anh:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4 - Video tiếng Trung:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4 - JSON tiếng Trung:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json
Sao chép dưới dạng Markdown
Khối này phản ánh nội dung tổng quan trong index.md, để người dùng có thể dán vào phiên lập trình bằng AI và tác nhân có thể phân tích dưới dạng Markdown thuần túy.
Dành cho công cụ lập trình AI
Cung cấp cho trợ lý các tài liệu Bắt đầu nhanh, Xác thực, Xóa phụ đề, Dịch video, Trích xuất phụ đề và Kỹ năng API Weydub. Sau đó, chỉ cung cấp thông tin xác thực qua biến môi trường. Đây là lộ trình dành cho Codex, Cursor, Claude Code, bot nội bộ và tác nhân tự động hóa.
Trợ giúp và hướng dẫn
Các trang API tại đây là nguồn tham chiếu chuẩn cho việc triển khai. Để được trợ giúp về quy trình làm việc với sản phẩm, hãy dùng trung tâm trợ giúp Weydub tại đây.