배치 처리

여러 파일의 텍스트 변환을 동시에 자동화하세요. 효율성과 결과를 극대화하기 위한 전략, 모니터링 및 모범 사례를 알아보세요.

배치 처리의 이점

작동 방식

대시보드를 통한 방법

API를 통한 방법

# 여러 파일 업로드
curl -X POST https://api.vozparatexto.com.br/v1/batch/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files[]=@audio1.mp3" \
  -F "files[]=@audio2.mp3" \
  -F "files[]=@audio3.mp3" \
  -F "engine=ASSEMBLYAI" \
  -F "language=en-US"

// 응답
{
  "batchId": "batch_abc123",
  "totalFiles": 3,
  "status": "PROCESSING",
  "files": [
    { "id": "upload_1", "name": "audio1.mp3", "status": "QUEUED" },
    { "id": "upload_2", "name": "audio2.mp3", "status": "QUEUED" },
    { "id": "upload_3", "name": "audio3.mp3", "status": "QUEUED" }
  ]
}

한계 및 설정

배치 모니터링

파일 상태

모니터링 대시보드

배치 패널에는 다음이 표시됩니다:

• 전체 배치 진행률 (백분율)
• 개별 파일 상태
• 예상 완료 시간
• 소비된 크레딧 대 예상 크레딧
• 파일별 오류 로그

최적화 전략

파일 구성

• 프로젝트 또는 주제별로 파일 그룹화
• 일관된 명명 규칙 사용
• 필요한 경우 언어별로 분리
• 우선순위별 정렬

권장 설정

• 품질을 원하면 AssemblyAI(기본값, 분당 4사이클, 화자 구분 및 문장 부호 지원)를 사용하고, 대량 작업을 더 저렴하게 처리하려면 Whisper(Normal, 분당 1사이클)를 사용하세요
• 필요한 경우에만 화자 식별 활성화
• 정확도를 높이기 위해 올바른 언어 선택
• 완료 알림을 위한 웹훅 설정

문제 해결

일부 파일이 배치에서 실패함

가능한 원인: 지원되지 않는 형식, 손상된 파일, 크레딧 부족.

해결 방법: 실패한 파일의 형식을 확인하고, 개별적으로 다시 처리해 보며, 크레딧 잔액을 확인하세요.

처리 속도가 매우 느림

가능한 원인: 대용량 파일이 많음, 피크 시간, 병렬 처리 제한.

해결 방법: 더 작은 배치로 나누고, 피크 시간 외에 제출하며, 병렬 슬롯을 늘리기 위해 요금제 업그레이드를 고려하세요.

파일 간 결과 불일치

가능한 원인: 다양한 오디오 품질, 다른 언어, 잘못된 설정.

해결 방법: 업로드 전에 오디오를 정규화하고, 필요에 따라 파일별로 언어를 설정하며, 배치 설정을 검토하세요.

더 알아보기

• API 통합 - API를 통해 배치 업로드 자동화
• 웹훅 및 알림 - 완료 알림 수신
• 워크플로 자동화 - 배치를 위한 자동화 흐름 생성