# 더빙 빠른 시작

이 문서는 영어 [Dubbing Quickstart](/content/docs/dubbing-quickstart/index.html) 의 한국어 번역입니다. 마지막 동기화: 2026년 3월 17일.

5분 안에 오디오 또는 비디오를 다른 언어로 더빙합니다. SDK 불필요 — REST API 호출만으로 가능합니다.

## 사전 요구사항

- [개발자 포탈](https://portal.startpinch.com/dashboard/developers) 에서 발급받은 Pinch API 키
- 오디오 파일(WAV, MP3, FLAC, OGG, M4A, AAC, WMA) 또는 비디오 파일(MP4, MOV, MKV, WebM, AVI) — 또는 공개 URL

## 빠른 예제

```
# 1. URL로 더빙 작업 생성
curl -X POST https://api.startpinch.com/api/dubbing/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://example.com/video.mp4",
    "source_lang": "auto",
    "target_lang": "ko"
  }'

# 응답: { "job_id": "abc-123", "status": "pending", ... }

# 2. 완료 폴링
curl https://api.startpinch.com/api/dubbing/jobs/abc-123 \
  -H "Authorization: Bearer YOUR_API_KEY"

# 3. 상태가 "completed"이면 결과 다운로드
curl https://api.startpinch.com/api/dubbing/jobs/abc-123/result \
  -H "Authorization: Bearer YOUR_API_KEY"

# 응답: { "download_url": "https://...", "expires_at": "..." }
```

## 로컬 파일 업로드

파일이 공개 접근 불가능한 경우 먼저 업로드합니다:

```
# 1. 사전 서명된 업로드 URL 획득
curl -X POST https://api.startpinch.com/api/dubbing/upload-url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "my-video.mp4", "content_type": "video/mp4"}'

# 응답: { "upload_url": "https://...", "source_url": "https://..." }

# 2. S3에 직접 업로드
curl -X PUT "UPLOAD_URL_FROM_STEP_1" \
  -H "Content-Type: video/mp4" \
  --data-binary @my-video.mp4

# 3. 1단계의 source_url로 더빙 작업 생성
curl -X POST https://api.startpinch.com/api/dubbing/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "SOURCE_URL_FROM_STEP_1",
    "target_lang": "ko"
  }'
```

## 작업 수명주기

작업은 다음 상태를 거칩니다:

```
pending → downloading → processing → uploading → completed
                                                → failed
```

`GET /api/dubbing/jobs/{id}`를 폴링하여 진행 상황을 추적합니다. 일반적인 처리 시간은 입력 1분당 2-5분입니다.

## 가격 및 제한

|  |  |
| --- | --- |
| **가격** | 입력 미디어 분당 $0.50 |
| **최대 길이** | 10분 |
| **최소 길이** | 1초 |
| **최대 파일 크기** | 500 MB |
| **입력 형식** | 비디오: MP4, MOV, MKV, WebM, AVI; 오디오: WAV, MP3, FLAC, OGG, M4A, AAC, WMA |
| **출력 형식** | 비디오 입력: MP4 (H.264 + AAC); 오디오 입력: MP3 또는 WAV |
| **속도 제한** | 분당 10개 작업 |
| **출력 만료** | 다운로드 URL은 48시간 후 만료 |

## 지원 언어

| 코드 | 언어 |
| --- | --- |
| `en` | 영어 |
| `es` | 스페인어 |
| `fr` | 프랑스어 |
| `de` | 독일어 |
| `it` | 이탈리아어 |
| `pt` | 포르투갈어 |
| `ru` | 러시아어 |
| `ja` | 일본어 |
| `ko` | 한국어 |
| `zh` | 중국어 |

## 다음 단계

- [Dubbing API Reference](/content/docs/dubbing-api/index.html) — 전체 엔드포인트 문서
- [더빙 대시보드](https://portal.startpinch.com/dashboard/dubbing) — 브라우저에서 오디오/비디오 더빙
- [Python 튜토리얼](/content/guides/how-to-dub-videos-with-python/index.html) — 배치 처리 포함 완전한 Python 가이드