Pinch PINCH

더빙 빠른 시작

이 문서는 영어 Dubbing Quickstart의 한국어 번역입니다. 마지막 동기화: 2026년 3월 17일.

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

사전 요구사항

  • 개발자 포탈에서 발급받은 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중국어

다음 단계