W API Weydub

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.

  1. 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.
  2. Đọ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ố.
  3. 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.
  4. 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.

01

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.crf khi được bật
02

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
03

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
04

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ộ.

Giới hạn videoGiới hạn cứng hiện tại cho mỗi tệp video là 15 phút và 1000 MB. Hãy chia nhỏ hoặc nén tệp trước khi gửi.
Giới hạn hình ảnhTối đa 2000*2000 px và 50 MB. Các định dạng được hỗ trợ: png, jpeg, jpg, bmp, webp. URL không được chứa ký tự tiếng Trung.
Thanh toánQuy trình video được tính phí theo đơn vị 30 giây. Chi phí của các dịch vụ kết hợp có thể cộng dồn. Tác vụ thất bại ở trạng thái cuối không bị trừ tín dụng.
CallbackXác minh Callback-Sign. Sau khi lưu trữ bền vững, trả về HTTP 200 cùng phần nội dung không trống. Callback thất bại sẽ được thử lại trong 24 giờ, khoảng 30 phút một lần.

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.

Nhà phát triển dùng công cụ lập trình AI Đọc phần tổng quan, sao chép Markdown vào trợ lý IDE, chạy các kịch bản demo rồi cung cấp thông tin xác thực qua biến môi trường.
Tác nhân tự động hóa và bot nội bộ Tải tài liệu tham chiếu và kỹ năng cho tác nhân, tạo tác vụ bất đồng bộ, lưu ID công việc, xử lý callback theo cách lũy đẳng và tuyệt đối không để lộ AppSecret.

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.

  1. 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.
  2. Lưu trữ thông tin bí mậtDùng WEYDUB_APP_KEY và WEYDUB_APP_SECRET hoặc trình quản lý thông tin bí mật.
  3. 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 đó.
  4. 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ề.
  5. 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.
  6. 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.
  7. 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.
  8. 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.

  • 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.

Tổng quan API Weydub Markdown sẵn sàng cho công cụ lập trình và tác nhân tự động hóa.

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.