# 빠른 시작

이 빠른 시작은 Weydub 동영상 텍스트 제거 작업을 제출하고 결과가 준비될 때까지 폴링합니다. 사람 개발자 또는 AI 코딩 도구가 백엔드 스크립트에 복사해 넣어 자격 증명을 신속하게 확인할 수 있도록 의도적으로 간결하게 구성했습니다.

## 사전 요구사항

- Weydub 계정. 로그인한 사용자는 내 계정에서 API 액세스를 무료로 활성화할 수 있습니다.
- `AppKey` 및 `AppSecret`.
- 공개적으로 접근할 수 있는 동영상 URL. 지원되는 형식에는 `mp4`, `avi`, `mov`, `mkv`, `mpg`, `m3u8` 및 `m4v`이 포함됩니다.

## 권장 환경 변수

```bash
export WEYDUB_APP_KEY="your_app_key"
export WEYDUB_APP_SECRET="your_app_secret"
```

## Python 예제

```python
import hashlib
import json
import os
import time

import requests

APP_KEY = os.environ["WEYDUB_APP_KEY"]
APP_SECRET = os.environ["WEYDUB_APP_SECRET"]
BASE_URL = "https://api.zhaoli.com"


def api_post(path: str, payload: dict) -> dict:
    body = json.dumps(payload, ensure_ascii=False, separators=(",", ":"))
    body_md5 = hashlib.md5(body.encode("utf-8")).hexdigest()
    app_sign = hashlib.md5((body_md5 + APP_SECRET).encode("utf-8")).hexdigest()
    headers = {
        "Content-Type": "application/json",
        "AppKey": APP_KEY,
        "AppSign": app_sign,
    }
    response = requests.post(f"{BASE_URL}{path}", headers=headers, data=body, timeout=30)
    response.raise_for_status()
    return response.json()


create_res = api_post(
    "/v-w-c/gateway/ve/work/free",
    {
        "urls": ["https://example.com/demo.mp4"],
        "needChineseOcclude": 1,
        "videoInpaintLang": "all",
    },
)

work_id = create_res["body"]["dataList"][0]["id"]
print("Created work:", work_id)

while True:
    status_res = api_post("/v-w-c/gateway/ve/work/status", {"idWorks": [work_id]})
    item = status_res["body"]["content"][0]
    process_status = item["processStatus"]

    if process_status == 1:
        print("Done:", item.get("videoUrl"))
        break
    if process_status > 1:
        raise RuntimeError(item.get("errorDetail") or "Task failed")

    print("Processing...")
    time.sleep(10)
```

## 다음 단계

- 프로덕션급 비동기 처리가 필요한 경우 `callback` URL을 추가하세요.
- 반환된 미디어 URL을 신속하게 저장하세요. 생성된 에셋에는 플랫폼 보존 정책이 적용됩니다.
- 앱에서 고객 또는 테넌트별로 작업 공간을 분리해야 하는 경우 `uid`을 사용하세요.
- 고객 미디어를 사용하기 전에 [데모 시나리오](./demo-scenarios.md)를 실행하세요.

## AI 코딩 도구용

어시스턴트에게 다음을 지시하세요:

- 코드를 편집하기 전에 [인증 및 서명](./auth-and-signing.md)을 읽으세요.
- 자격 증명을 `WEYDUB_APP_KEY` 및 `WEYDUB_APP_SECRET`에 보관하세요.
- `AppSecret`을 사용하여 브라우저 코드에서 Weydub을 호출하지 않는 백엔드 전용 클라이언트를 구축하세요.
- 전송할 정확히 동일한 컴팩트 JSON 본문에 서명하세요.
- 비밀 정보를 출력하지 않고 엔드포인트와 페이로드를 출력하는 드라이런 모드를 추가하세요.