배치 처리

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

배치 처리의 이점

작동 방식

대시보드를 통한 방법

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

한계 및 설정

| 리소스 | 무료 요금제 | 라이트 요금제 | 어드밴스드 요금제 | 프로 요금제 | |---|---|---|---|---| | 배치당 파일 수 | 3 | 10 | 25 | 100 | | 병렬 처리 | 1 | 2 | 3 | 5 | | 최대 배치 크기 | 100 MB | 500 MB | 2 GB | 10 GB | | 대기열 우선순위 | 보통 | 보통 | 높음 | 최대 |

배치 모니터링

파일 상태

| 상태 | 설명 | |---|---| | QUEUED | 처리 대기 중 | | UPLOADING | 업로드 진행 중 | | PROCESSING | 텍스트 변환 진행 중 | | COMPLETED | 텍스트 변환 완료됨 | | FAILED | 처리 실패 | | RETRYING | 자동 재시도 중 |

모니터링 대시보드

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

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

최적화 전략

파일 구성

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

권장 설정

• 최상의 비용 효율성을 위해 AssemblyAI 사용 (분당 15사이클)
• 필요한 경우에만 화자 식별 활성화
• 정확도를 높이기 위해 올바른 언어 선택
• 완료 알림을 위한 웹훅 설정

문제 해결

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

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

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

처리 속도가 매우 느림

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

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

파일 간 결과 불일치

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

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

더 알아보기

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