개요: Ingest Profiles API

이 주제에서는 Ingest Profiles API에 대한 개요를 제공합니다. Ingest Profiles API를 사용하면 Video Cloud 계정에 대한 변환 프로필을 생성, 검색, 업데이트 및 삭제할 수 있습니다.

수집 프로필 관리

인제스트 프로필은 비디오를 업로드하거나 다시 트랜스코딩할 때 트랜스코딩을 위한 사양으로 사용됩니다. Ingest Profiles API를 사용하여 이러한 프로필을 관리할 수 있습니다.

용어집

프로필 JSON

아래 "프로필 JSON"이라는 용어는 프로필 개체의 JSON 표현을 의미합니다. 여기에는 최상위 프로필 필드와 rendition 개체 모음이 목록으로 포함됩니다. 보다표준 프로파일모든 계정에 포함된 표준 프로필에 대한 JSON을 확인하고콘텐츠 보안(DRM 및 HLSe) DRM 패키징을 포함하는 샘플 프로필의 경우.

프로필 ID

NS profile id둘 중 하나가 될 수 있습니다id또는name프로필의 최상위 필드. 이 예에서(프로필의 일부):

    {
        "id": "5591b5ede4b0f7138939ad8c",
        "version": 4,
        "name": "screencast-1280",
        "description": "A high resolution profile optimized for screencasts with 1280 x 720 resolution.", ...

"screencast-1280" 또는 "5591b5ede4b0f7138939ad8c"는 모두 유효한 프로필 ID입니다. 프로필을 처음 생성할 때 이름은 있지만 ID가 없는 프로필을 제공하고 응답에는 해당 ID를 포함하여 생성된 프로필이 포함됩니다. 그런 다음 후속 API 호출에서 둘 중 하나를 사용할 수 있습니다.

참조 ID

NS reference_id프로필 내에서 변환을 고유하게 식별합니다. 참조 ID는 DRM 패키징에 사용되며 향후 다른 용도로 사용될 수 있습니다. 프로필 내에서 고유한 것 외에 참조 ID는 모든 문자열이 될 수 있으며 공백을 포함해서는 안 됩니다. 변환 형식을 쉽게 식별할 수 있는 몇 가지 구성표를 사용하는 것이 좋습니다. 예를 들면 다음과 같습니다. mp4_1 , mp4_2 , hls1 , hls2 , 등.

프로필 버전

NS version계정 프로필의 개정 번호입니다. 긴 정수 값으로 표시됩니다. 참고: JSON 표현에서는 인용되지 않습니다.

활성 프로필

프로필은active업로드에 사용할 수 있는 경우. 예를 들어 프로필을 업데이트하면 활성화된 버전 번호가 증가된 새 프로필이 생성되고 이전 버전은 비활성화됩니다.

표준 프로필

프로필은standard Brightcove에서 사용하기 위해 제공한 경우(즉, 단일 계정에 특정한 사용자 지정 프로필이 아님).

기본 프로필

프로필은default프로필이 명시적으로 선택되지 않은 경우 사용됩니다. 계정 구성이 없거나 구성에 기본 프로필을 설정하지 않은 경우 Brightcove standard프로필은 계정 유형에 따라 사용됩니다.

기본 URL

서비스 URL은 다음과 같습니다.

    https://ingestion.api.brightcove.com/v1/

권한 부여

API에 대한 인증은 Brightcove의 OAuth2 구현을 통해 이루어집니다. 계정에서 다음 작업에 대한 권한이 있는 클라이언트 자격 증명(클라이언트 ID 및 클라이언트 암호)이 필요합니다.

video-cloud/ingest-profiles/profile/read
video-cloud/ingest-profiles/profile/write
video-cloud/ingest-profiles/account/read
video-cloud/ingest-profiles/account/write

얻으려면client_id그리고client_secret , OAuth UI로 이동하여 앱을 등록해야 합니다.

API 인증 자격 증명 관리

CURL 또는 Postman을 통해 자격 증명을 얻을 수도 있습니다. 다음을 참조하세요.

클라이언트 자격 증명을 사용하여 API를 호출할 수 있는 액세스 토큰을 얻습니다. 액세스 토큰은 Authorization 헤더로 전달됩니다.

    Authorization: Bearer {your_access_token}

참조인증 섹션자세한 내용은.

최대 변환

수집 프로필에서 정의할 수 있는 최대 변환 수는 25개입니다. 해당 수보다 많이 정의하면 요청에서 오류 409 응답을 반환합니다. 프로필 변환 수가 구성된 변환 제한을 초과했습니다.

조건부 출력

수집하는 비디오의 품질이 크게 다른 경우(예: 비디오에 품질이 낮은 카메라로 휴대폰에서 만든 사용자 생성 콘텐츠가 포함될 수 있음) 일부 변환 생성을 비트 전송률 또는 기타 속성에 따라 만들 수 있습니다. 소스 영상. 이렇게 하면 중복 변환의 생성 및 저장이 방지됩니다. 보다조건부 출력이 작업을 수행하는 방법에 대한 자세한 내용은

계정 운영

계정 수준에서 계정에 대한 모든 프로필을 가져오고 새 프로필을 만들 수 있습니다.

끝점

    /accounts/{account_id}/profiles

모든 프로필 가져오기

계정에 대한 모든 프로필을 가져오려면(포함표준 프로파일 ), 위에 표시된 엔드포인트에 GET 요청을 제출합니다.

프로필 만들기

새 프로필을 만들려면 프로필에 대한 JSON 데이터를 요청 본문으로 포함하여 위에 표시된 엔드포인트에 POST 요청을 제출합니다. 참조샘플 프로필 JSON 데이터의 예는 아래에 있으며프로필 필드 참조허용되는 필드에 대해.

단일 프로필 작업

개별 프로필의 경우 이름 또는 ID로 프로필을 가져오고 프로필을 교체하고 프로필을 삭제할 수 있습니다.

끝점

    /accounts/{account_id}/profiles/{profile_id}

를 위해profile_id , 다음 중 하나를 사용할 수 있습니다.

이름(예: 균형 잡힌 고화질)
생성된 ID(예: 54de14cce4b0a6d2bf9cb08a)

아이디로 프로필 받기

단일 프로필을 검색하려면 위에 표시된 엔드포인트에 GET 요청을 수행합니다.

프로필 업데이트

프로필을 업데이트하려면 위의 엔드포인트에 PUT 요청을 하십시오. 완벽한 요청 본문의 프로필에 대한 JSON 데이터입니다.

참고: 업데이트된 프로필의 JSON ~해야하다포함id재산.

프로필 삭제

프로필을 삭제하려면 위의 엔드포인트에 DELETE 요청을 하세요.

이 조치는뒤집을 수 없는

기본 프로필 작업

엔드포인트를 사용하여 계정에 대한 기본 주문형 비디오 및 라이브 비디오 프로필을 가져오거나 설정하거나 업데이트할 수 있습니다.

    /accounts/{account_id}/configuration

기본 프로필 가져오기

위의 엔드포인트에 GET 요청을 수행하여 계정의 기본 프로필을 검색합니다.

기본 프로필이 설정되지 않은 경우 시스템 기본 프로필이 반환됩니다.

기본 프로필 설정

기본 프로필을 설정하려면 요청 본문의 JSON을 포함하여 위에 표시된 엔드포인트에 POST 요청을 수행합니다.

    {
      "account_id": {account_id},
      "default_profile_id": {default_profile_id}
    }

를 위해default_profile_id , 다음 중 하나를 사용할 수 있습니다.

이름(예: 균형 잡힌 고화질)
생성된 ID(예: 54de14cce4b0a6d2bf9cb08a)

기본 프로필 업데이트

기본 프로필을 업데이트하려면 요청 본문에 이 JSON을 포함하여 위에 표시된 엔드포인트에 PUT 요청을 수행합니다.

    {
      "id": {configuration_id},
      "account_id": {account_id},
      "default_profile_id": {default_profile_id}
    }

가져오기configuration_id GET 또는 POST 요청에 대한 응답에서.

기본 라이브 프로필 설정

기본 라이브 프로필을 설정하는 것은 요청 본문의 다음 변경 사항을 제외하고 기본 주문형 비디오 프로필을 설정하는 것과 정확히 동일합니다.

    {
      "id": {configuration_id},
      "account_id": {account_id},
      "default_live_profile_id": {default_live_profile_id}
    }

노트:

존재하지 않는 프로필을 지정하면 요청이 실패합니다.

샘플 프로필

NS 표준 프로파일문서는 모든 Video Cloud 계정에 대해 현재 존재하는 모든 기본 프로필을 보여줍니다.

워터마크

비디오에 워터마크(또는 로고 이미지)를 추가하려면 인제스트 프로필에서 워터마크 필드를 사용할 수 있습니다.

다음은 워터마크가 있는 변환 프로필의 예입니다.

    ...
    "renditions": [
        {
          "media_type": "video",
          "id": "559697ece4b072e9641b8404",
          "reference_id": "mp0",
          "format": "mp4",
          "audio_codec": "aac",
          "audio_bitrate": 64,
          "video_codec": "h264",
          "speed": 3,
          "video_bitrate": 450,
          "decoder_bitrate_cap": 771,
          "decoder_buffer_size": 1028,
          "keyframe_rate": 0.5,
          "max_frame_rate": 30,
          "width": 480,
          "height": 270,
          "h264_profile": "baseline",
          "watermarks": [
            {
              "y": "70%",
              "width": "20%",
              "url": "http://learning-services-media.brightcove.com/images/bc_logo.png"
            }
          ]
      }, ...

필드에 대한 전체 설명은 <a href="https://zencoder.support.brightcove.com/encoding-settings/assets/encoding-settings-watermarks.html>워터마크 필드 참조</a>를 참조하세요.</a> p> </section> </article>