동적 인제스트 API: 모범 사례

이 항목에서는 동적 인제스트 API 사용에 대한 모범 사례를 제공합니다.

서문

Dynamic Ingest API은 강력하고 유연하지만 가장 효과적으로 사용하려면 아래에 자세히 나와 있는 몇 가지 모범 사례를 따라야 합니다.

모범 사례

다음은 동적 인제스트 규칙 및 지침입니다.

  • 인제스트 요청profile필드는선택사항입니다 . 하드 코딩을 피하십시오profile 앱 및 통합에서 - 대신 가장 일반적으로 사용되는 프로필을기본계정에 대한 필드를 생략하거나계정에 사용 가능한 프로필 가져오기사용자가 하나를 선택하도록 강제합니다.
  • 동일한 동영상에 대해 분당 10회 이하의 요청이 허용됩니다.
  • 동일한 작업에서 비디오와 함께 이미지 및 텍스트 트랙과 같은 다른 자산을 수집하는 것은 괜찮지만 동일한 비디오에 대해 중복 작업 처리가 없어야 합니다.

    잠재적으로 동일한 비디오 ID로 여러 작업을 생성할 수 있는 처리 작업 생성을 위해 자동화된 프로세스를 사용하는 경우 알림을 확인하여 새 비디오를 생성하기 전에 동일한 비디오에서 처리 중인 다른 작업이 없는지 확인해야 합니다.

  • 각 계정의 총 요청에 대한 초당 요청 수는 20개로Dynamic Ingest제한됩니다CMS API .
  • 계정당 동시 일반 우선 순위 DI 작업은 100개로 제한됩니다.
  • 보류 중인 낮은 우선순위 작업은 1000개로 제한됩니다.
  • 대량의 파일 배치를 수집하는 경우 다음을 사용하는 것이 좋습니다. 낮은 우선 순위 대기열그러면 100개 이상의 작업을 대기열에 추가할 수 있습니다.
  • 수집 콘텐츠는 일반적으로 파일당 100GB로 제한됩니다(더 큰 파일을 수집해야 하는 경우 고객 성공 관리자에게 문의하십시오).
  • 파일을 일괄적으로 인제스트하는 경우 일반 우선 순위의 동시 작업을 100개로 제한하고 한 작업이 처리를 완료할 때까지 기다린 다음 다른 작업을 추가하십시오. 자세한 내용은폴백/재시도 전략을참조하십시오. 또는 낮은 우선 순위를 사용하여"priority": "low" -를 설정할 수 있습니다. 처리 시간이 조금 더 걸릴 수 있지만 인제스트 대기열의 크기에 대해 걱정할 필요는 없습니다.
  • 전체 배치를 수집하기 전에 인제스트 프로파일 변경을 검증하여 원하는 결과를 얻는지 확인합니다.

대량 수집/마이그레이션

다른 플랫폼에서 Video Cloud로 비디오를 마이그레이션하거나 수집해야 하는 비디오가 많은 경우 다음 지침에 따라 프로세스를 원활하게 진행할 수 있도록 도와드리겠습니다.

  • 최소 3일 전에 Support 티켓을 열어 대량의 자산을 수집할계획임을 알려주십시오.
  • 시작하고 끝낼 것으로 예상되는 일정을 제공하십시오.
  • 사용할 수집 방법을 나타냅니다. API, MRSS, Aspera(XML 매니페스트가 없는 경우).
  • 처리할 총 비디오 수를 나타냅니다.
  • 평균 비디오 파일 크기를 나타냅니다.
  • 평균 동영상 길이(분)를 나타냅니다.
  • 콘텐츠가 있는 지역을 나타냅니다.