개발자 문서

미디어 현지화, 사람 개발자 및 자동화 에이전트를 위한 Weydub API

서명된 요청 하나로 시작한 다음, 자막 및 텍스트 제거, 동영상 번역, 자막 추출, 이미지 번역, 콜백과 자동화를 위한 운영 워크플로로 넘어가세요. 로그인한 Weydub 사용자는 내 계정에서 API 액세스를 무료로 열 수 있습니다.

무료 API 액세스 열기 API 키 관리 첫 요청 실행 API 레퍼런스 열기 Markdown 문서 복사 에이전트 스킬 열기

기본 URL https://api.zhaoli.com

인증 AppKey 및 AppSign. 다음은 AppSecret 서버에서만 보관하세요.

액세스 무료 API 액세스 열기 또는 내 계정에서 API 키 관리 를 선택하고, 운영 환경에 적용하기 전에 이미지 API, Advanced Lite/Pro 제거, 고감정 더빙 및 일괄 처리 제한을 확인하세요.

비동기 작업을 만들고 ID를 저장한 다음, 완료 여부는 콜백이나 폴링으로 확인하세요.

에이전트 다음 자료를 llms.txt 및 weydub-api-skill.md 을 구현 전에 불러오세요.

개발자용 빠른 시작

자격 증명을 받고 서명된 호출을 한 번 실행한 뒤 상태를 확인하고 워크플로 페이지를 선택하세요. 이렇게 하면 사람이 빠르게 진행하면서도 에이전트가 충분한 구조를 바탕으로 안전하게 구축할 수 있습니다.

액세스 받기로그인하고 내 계정에서 API 액세스를 무료로 연 다음, 계정에 허용된 워크플로를 확인하세요.
레퍼런스 읽기엔드포인트, 요청 형식, 상태 필드 및 문제 해결 참고 사항을 확인하세요.
빠른 시작 실행환경 변수와 간결한 JSON 서명을 사용해 데모 작업을 하나 만드세요.
결과 확인상태를 폴링하거나 콜백을 받은 다음, 출력 URL과 오류를 저장하세요.

핵심 워크플로

API 홈페이지는 동영상에서 텍스트 정리, 동영상 번역, 자막 파일 추출, 이미지 번역이라는 네 가지 운영 작업을 중심으로 구성됩니다.

자막 및 텍스트 제거

영상에 삽입된 자막, 캡션, 워터마크, 로어 서드, 로고, 줄거리 힌트, 등록 번호 및 기타 보이는 텍스트를 정리합니다.

엔드포인트: /v-w-c/gateway/ve/work/free
Basic: needChineseOcclude: 1|2|3
Lite/Pro: advanced_lite, advanced_large_box, advanced_full
마스크: videoInpaintMasks
CRF: extraOptions.write_options.crf 활성화된 경우

API 문서 읽기 온라인에서 제거해 보기

동영상 번역

번역된 자막을 생성하고, 필요에 따라 AI 더빙을 추가하며, 현지화된 동영상 에셋을 렌더링합니다.

엔드포인트: /v-w-c/gateway/ve/work/free
더빙: needWanyin: 1, wyTaskType: FULL
프레임 내 텍스트: needChineseOcclude: 11
고감정: /voice/incorporate

API 문서 읽기 동영상 번역해 보기

자막 추출

OCR 또는 음성 대화용 ASR을 사용해 보이는 자막이나 음성 대화에서 SRT/VTT를 생성합니다.

OCR: needChineseOcclude: 14
OCR 마스크: type: trans_only_ocr
ASR: wyTaskType: ONLY_ASR, wyNeedText: 0

API 문서 읽기 자막 생성해 보기

이미지 번역

제품 이미지, 스크린샷, 만화 패널, 앱 UI 캡처 및 크리에이티브 에셋을 현지화합니다.

엔드포인트: /v-w-c/gateway/ve/image/translate
번역: translateOn: 1, synthesisOn: 1
텍스트 지우기: translateOn: 0, synthesisOn: 1

API 문서 읽기 이미지 번역해 보기

먼저 Weydub에서 사용해 보기

구현 전에 출력 품질을 확인하려는 사용자는 해당 Weydub 워크플로로 안내하세요. API 문서는 자동화, 서명, 콜백 및 운영 동작을 위해 이곳에 유지됩니다.

온라인에서 자막 제거웹 앱에서 자막과 텍스트 정리 결과를 확인합니다. 동영상 번역자막, 더빙 및 현지화된 동영상 결과를 확인합니다. 자막 생성OCR 또는 음성 자막 추출 결과를 눈으로 확인해 봅니다. 이미지 번역OCR, 지우기, 번역 및 레이아웃 합성을 사용해 봅니다.

운영 규칙

개발자와 에이전트가 구현 중 로컬 Weydub 문서를 기준으로 작업할 수 있도록 이 규칙을 API 페이지에 반영합니다.

동영상 제한현재 파일별 하드 제한은 15분 및 1000MB입니다. 제출 전에 분할하거나 압축하세요.

이미지 제한최대 2000*2000px 및 50MB입니다. 지원 형식: png, jpeg, jpg, bmp, webp. URL에 중국어 문자가 포함되어서는 안 됩니다.

청구동영상 워크플로는 30초 단위로 청구됩니다. 여러 서비스를 함께 사용하면 비용이 합산될 수 있습니다. 최종 실패 작업에는 크레딧이 차감되지 않습니다.

콜백Callback-Sign을 확인하세요. 안정적으로 저장한 후 HTTP 200과 비어 있지 않은 본문을 반환하세요. 실패한 콜백은 24시간 동안 약 30분 간격으로 재시도됩니다.

두 사용자층

이 문서는 AI 코딩 도구를 사용하는 사람과 간결하고 신뢰할 수 있는 계약이 필요한 자동화 에이전트를 위해 작성되었습니다.

AI 코딩 도구를 사용하는 개발자 개요를 읽고 Markdown을 IDE 어시스턴트에 복사한 다음 데모 시나리오를 실행하고 환경 변수를 통해 자격 증명을 연결하세요.

자동화 에이전트 및 내부 봇 에이전트 레퍼런스와 스킬을 불러오고, 비동기 작업을 만들고, 작업 ID를 저장하고, 콜백을 멱등적으로 처리하며, AppSecret을 절대 노출하지 마세요.

순서대로 읽기

먼저 다섯 가지 핵심 튜토리얼을 읽으세요. AI 코딩 도구나 내부 봇이 구현을 수행할 때는 에이전트 파일을 사용하세요.

빠른 시작텍스트 제거 작업을 만들고 폴링하는 최소한의 Python 흐름입니다. 인증 및 서명AppKey, AppSign 및 이중 MD5 서명 규칙입니다. 자막 제거Basic, Advanced Lite/Pro, 마스크, CRF 및 제거 페이로드입니다. 동영상 번역자막 번역, 더빙, 화면 텍스트 번역 및 음성 모드입니다. 자막 추출비동기 작업 처리와 함께 사용하는 OCR 및 ASR 자막 추출입니다. API 레퍼런스엔드포인트 색인, 요청 형식, 상태 필드 및 문제 해결 방법을 제공합니다. LLM 레퍼런스코딩 어시스턴트와 봇을 위한 간단한 안내 파일입니다. Weydub API 스킬Codex, Cursor, Claude Code 및 내부 에이전트에서 재사용할 수 있는 지침입니다.

통합 경로

스크립트, 백엔드 서비스, 노코드 브리지, 큐 작업자 및 AI 생성 클라이언트를 위한 구현 체크리스트로 사용하세요.

무료 액세스내 계정에서 API 액세스를 연 다음, 대상 워크플로에 대한 계정 권한을 확인하세요.
시크릿 저장다음 변수를 사용하세요: WEYDUB_APP_KEY 및 WEYDUB_APP_SECRET 또는 시크릿 매니저를 사용하세요.
정확하게 서명하기간결한 JSON으로 이중 MD5 서명을 생성한 후 동일한 본문 바이트를 전송하세요.
작업 만들기미디어 URL을 제출하고 반환된 프로젝트/워크/태스크 ID를 저장하세요.
안전하게 대기하기운영 환경에서는 콜백을 사용하고 폴링을 대체 수단으로 사용하세요.
결과 저장출력 URL, SRT 링크, 이미지 에셋, 상태 및 오류를 저장하세요.
데모 실행고객 미디어를 연결하기 전에 공식 에셋으로 확인하세요.
사용자 보호재시도를 멱등적으로 처리하고 AppSecret이 유출되지 않도록 하세요.

최소 호출 형식

자격 증명에는 환경 변수를 사용하세요. AppSecret을 프런트엔드 코드, 공개 저장소, 스크린샷, 로그 또는 보존될 수 있는 프롬프트에 절대 저장하지 마세요.

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"
}

데모 시나리오

고객 미디어를 연결하기 전에 이 공개 에셋으로 API 통합을 확인하세요. Weydub이 봇과 코딩 도구에서 가장 자주 호출할 것으로 예상하는 워크플로를 다룹니다.

시나리오 1

고급 텍스트 제거

Advanced Pro 전체 화면 모델을 사용해 영어 하드코딩 자막이 포함된 동영상을 제출하세요.

시나리오 2

동영상 번역

영어 데모 동영상을 자막과 AI 더빙을 포함한 스페인어로 번역하세요.

시나리오 3

고감정 음성 복제

중국어 동영상과 연결된 JSON을 사용해 숏드라마를 중국어에서 영어로 더빙하세요.

영어 동영상: http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4
중국어 동영상: http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4
중국어 JSON: http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json

Markdown으로 복사

이 블록은 index.md의 개요를 그대로 반영하므로, 사람이 AI 코딩 세션에 붙여 넣고 에이전트가 일반 Markdown으로 파싱할 수 있습니다.

Weydub API 개요 코딩 도구와 자동화 에이전트에서 바로 사용할 수 있는 Markdown입니다.

# Weydub API 문서

Weydub API는 자체적으로 OCR, ASR, 인페인팅, 번역, 더빙 또는 렌더링 인프라를 구축하지 않고 미디어 현지화가 필요한 팀, AI 코딩 도구 및 자동화 에이전트를 위한 개발자용 진입점입니다. 로그인한 Weydub 사용자는 내 계정에서 API 액세스를 무료로 열 수 있습니다.

## 핵심 워크플로

| 워크플로 | 용도 | 주요 엔드포인트 | 주요 필드 |
| --- | --- | --- | --- |
| 자막 및 화면 텍스트 제거 | 동영상에서 자막, 워터마크, 하단 자막, 로고, 줄거리 힌트, 등록 번호 및 기타 보이는 텍스트를 정리합니다. | `POST /v-w-c/gateway/ve/work/free` | `needChineseOcclude`, `videoInpaintLang`, `videoInpaintMasks`, `extraOptions.extra_inpaint_config` |
| 동영상 번역 | 원본 자막을 생성하고 대화를 번역하며, 선택적으로 AI 음성으로 더빙하고, 보이는 텍스트를 번역한 뒤 현지화된 동영상 에셋을 렌더링합니다. | `POST /v-w-c/gateway/ve/work/free` | `needWanyin`, `sourceLang`, `lang`, `wyTaskType`, `wyNeedText`, `wyVoiceParam` |
| 자막 추출 | OCR로 보이는 자막에서, ASR로 음성에서 SRT/VTT 파일을 생성합니다. | `POST /v-w-c/gateway/ve/work/free` | OCR: `needChineseOcclude: 14`; ASR: `wyTaskType: "ONLY_ASR"` |
| 이미지 번역 | 제품 이미지, 스크린샷, 만화, 앱 UI 캡처 및 마케팅 크리에이티브 내부의 텍스트를 번역하거나 지웁니다. | `POST /v-w-c/gateway/ve/image/translate` | `srcLang`, `tgtLang`, `translateOn`, `synthesisOn`, `downloadInfo` |

## 워크플로 신호

- 동영상 제거: Basic 전체 화면 `needChineseOcclude: 1`; Basic 영역 `needChineseOcclude: 2`; 움직이는 텍스트 `needChineseOcclude: 3`; Advanced Lite `advanced_lite`; Advanced Pro 바운딩 박스 `advanced_large_box`; 활성화된 경우 `extraOptions.write_options.crf`로 CRF를 재정의합니다.
- 동영상 번역: 전체 더빙 `needWanyin: 1`, `wyTaskType: "FULL"`, `wyNeedText: 1`; 화면 텍스트 번역 `needWanyin: 0`, `needChineseOcclude: 11`; 고감정 더빙 `/v-w-c/gateway/ve/work/voice/incorporate`.
- 자막 추출 OCR: `needChineseOcclude: 14`, `type: "trans_only_ocr"`인 `videoInpaintMasks`, `extraOptions.extra_inpaint_config`에서 선택적 OCR 정리.
- 자막 추출 ASR: `needWanyin: 1`, `wyTaskType: "ONLY_ASR"`, `needWyEdit: 0`, `wyNeedText: 0`, 선택적 `asr_speaker_detect_on`.
- 이미지 번역: `translateOn: 1`, `synthesisOn: 1`.
- 이미지 텍스트 제거: `translateOn: 0`, `synthesisOn: 1`.
- 이미지 재실행: `POST /v-w-c/gateway/ve/image/translate/redo`; 지원팀에서 달리 확인하지 않은 경우 번역/색상/글꼴 크기 필드만 수정합니다.

## 먼저 Weydub에서 사용해 보기

- 온라인에서 자막 제거: https://weydub.com/subtitle-removal/
- 동영상 번역: https://weydub.com/video-translator/
- 자막 생성: https://weydub.com/subtitle-generator/
- 이미지 번역: https://weydub.com/image-translator/

## 순서대로 읽기

1. 빠른 시작: https://weydub.com/docs/api/quickstart.md
2. 인증 및 서명: https://weydub.com/docs/api/auth-and-signing.md
3. 자막 제거: https://weydub.com/docs/api/video-subtitle-removal.md
4. 동영상 번역: https://weydub.com/docs/api/video-translation.md
5. 자막 추출: https://weydub.com/docs/api/subtitle-extraction.md
6. Weydub API 스킬: https://weydub.com/docs/api/weydub-api-skill.md
7. API 레퍼런스: https://weydub.com/docs/api/api-reference.md

## API 필수 정보

- 기본 URL: `https://api.zhaoli.com`
- 인증 헤더: `AppKey`, `AppSign`
- 서명: `AppSign = md5(md5(request_body) + AppSecret)`
- 서명 없이 사용하는 열거형 엔드포인트: `POST /v-w-c/enum/query2`
- 대부분의 미디어 작업은 비동기입니다.
- 내 계정에서 API 액세스를 무료로 열고, 운영 환경에 적용하기 전에 이미지 API, Advanced Lite/Pro 제거, 고감정 더빙 및 일괄 처리 제한을 확인하세요.
- 운영 환경에서는 콜백을 사용하고 폴링을 대체 수단으로 사용하세요.
- 콜백 헤더 `Callback-Sign`을 확인하세요.
- `AppSecret`은 서버 측에만 유지하세요.

## 제한 및 보존

- 동영상 파일별 하드 제한: 15분.
- 동영상 파일별 하드 제한: 1000MB.
- 이미지 하드 제한: `2000*2000 px`, `50 MB`.
- 이미지 형식: `png`, `jpeg`, `jpg`, `bmp`, `webp`.
- 이미지 URL에 중국어 문자가 포함되어서는 안 됩니다.
- 동영상 청구 단위: 30초.
- 최종 실패 작업(`processStatus > 1`)에는 크레딧이 차감되지 않습니다.
- 기본 보존 설정은 최근 30일의 원본/렌더링 에셋을 보관합니다. 콜백 후 결과 URL과 에셋을 저장하세요.

## 에이전트 운영 규칙

- 자격 증명, 엔드포인트 사용 가능 여부 또는 계정 권한을 추측하지 마세요.
- `AppSecret`을 프런트엔드 코드, 브라우저 확장 프로그램, 공개 저장소, 로그, 스크린샷 또는 보존되는 프롬프트에 절대 넣지 마세요.
- 전송할 정확한 간결한 JSON 본문에 서명하세요.
- 각 워크플로 페이지에서 지정한 형식에 맞춰 `extraOptions`, `wyVoiceParam`, `videoInpaintMasks`, `downloadInfo`, `downloadInfos` 및 재실행 `result` 같은 중첩 옵션을 유지하세요.
- 자체 작업 테이블에 프로젝트 ID, 작업 ID, 이미지 작업 ID, 소스 URL, 상태, 오류 세부 정보 및 결과 URL을 저장하세요.
- 고객 미디어를 연결하기 전에 공개 데모 에셋을 사용하세요.

AI 코딩 도구용

어시스턴트에게 빠른 시작, 인증, 자막 제거, 동영상 번역, 자막 추출 및 Weydub API 스킬을 제공하세요. 그런 다음 환경 변수로만 자격 증명을 전달하세요. 이것이 Codex, Cursor, Claude Code, 내부 봇 및 자동화 에이전트를 위한 권장 경로입니다.

에이전트 스킬 읽기 API 레퍼런스 열기 llms.txt 열기 원본 Skill Markdown Markdown 개요 열기

도움말 및 튜토리얼

로컬 API 페이지가 구현의 기준입니다. 제품 워크플로에 관한 도움말은 로컬 Weydub 도움말 센터에서 확인하세요.

Weydub 도움말 크레딧 및 결제 규칙 일괄 다운로드 Weydub Studio 가이드