작업 설정

이 항목에는 전체 작업과 관련된 인코딩 설정에 대한 세부 정보가 포함되어 있습니다.

api_key

api_key:String

API 버전: V2

유효한 값 : Zencoder API 키 https://app.zencoder.com/api

호환 가능한 작업 유형: VOD

예: bcafecadfe 카바 페닥

설명:

Zencoder 계정의 API 키입니다. API 키는 다음에서 찾을 수 있습니다. https://app.zencoder.com/api . 해당 페이지에서 API 키를 다시 생성 할 수도 있습니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "api_key": "bcafecadfecabafedac"
  }

dynamic_profile_options

dynamic_profile_options:Object

API 버전: V2

호환 가능한 작업 유형: VOD

설명:

CAE를 사용하면 이러한 출력의 출력 수와 매개 변수가 각 입력 파일에 대해 동적으로 변경될 수 있습니다. 그만큼dynamic_profile_options설정은 변환을 만드는 방법을 정의합니다. 보다 CAE 설정자세한 내용은. 당신은 또한 설정해야합니다 generate_dynamic_profile동일true이 기능을 사용합니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "generate_dynamic_profile": true,
    "dynamic_profile_options": {
      "min_renditions": 2,
      "max_renditions": 8
    },
    "outputs" :[
      {"dynamic_profile_rendition": 1},
      {"dynamic_profile_rendition": 2},
      {"dynamic_profile_rendition": 3},
      {"dynamic_profile_rendition": 4},
      {"dynamic_profile_rendition": 5},
      {"dynamic_profile_rendition": 6},
      {"dynamic_profile_rendition": 7},
      {"dynamic_profile_rendition": 8}
  ]
  }

generate_dynamic_profile

generate_dynamic_profile:Boolean

API 버전: V2

유효한 값 :참 또는 거짓

기본값:그릇된

호환 가능한 작업 유형: VOD

설명:

CAE를 사용하면 이러한 출력의 출력 수와 매개 변수가 각 입력 파일에 대해 동적으로 변경될 수 있습니다. 생성 할 출력 수에 대한 제한과 기타 프로필 제약을 지정하려면 CAE 작업 요청에 다음이 포함되어야합니다. dynamic_profile_options목적. CAE 사용을 위해 예약 된 출력에는 다음이 포함되지 않아야합니다. resolution , bitrate또는 코덱 관련 매개 변수입니다. 대신 라벨을 포함해야합니다. dynamic_profile_rendition . CAE 사용을 위해 예약 된 출력 수는 다음과 같이 지정된 수와 일치해야합니다. max_renditions에dynamic_profile_options .

  {
    "input": "s3://zencodertesting/test.mov",
    "generate_dynamic_profile": true,
    "dynamic_profile_options": {
      "min_renditions": 2,
      "max_renditions": 8
    },
    "outputs" :[
       {"dynamic_profile_rendition": 1},
       {"dynamic_profile_rendition": 2},
       {"dynamic_profile_rendition": 3},
       {"dynamic_profile_rendition": 4},
       {"dynamic_profile_rendition": 5},
       {"dynamic_profile_rendition": 6},
       {"dynamic_profile_rendition": 7},
       {"dynamic_profile_rendition": 8}
    ]
  }

input

input:String

API 버전: V2

유효한 값 : 인증 여부에 관계없이 미디어 파일 (HTTP / HTTPS, FTP / FTPS, SFTP, Azure, GCS, CF 또는 S3)에 대한 유효한 URL

호환 작업 유형: VOD

예:

http://example.com/path/to/input.avi
sftp : // user : pass@example.com/path/to/input.mp3
s3 : //my-bucket/video.mp4
cf : // username : api_key@container/video.wmv
cf + uk : // username : api_key@container/video.wmv
azure : // account-name : account-key@container/video.wmv
gcs : // access_key : secret_key@gcs-bucket/video.mov
aspera : // user : pass @ host : ssh-port / path / to / file.mp4
s3 + eu-central-1 : //my-bucket/video.mp4

설명:

트랜스 코딩 할 파일의 URL입니다. 원격 서버에 인증이 필요한 경우 입력 URL 문자열에 사용자 이름과 비밀번호를 포함해야합니다.

URL에 특수 문자를 사용한 인증이 포함 된 경우그들이 제대로 이스케이프되었는지 확인하십시오 .

S3에 대한 참고 사항 :

당신은부여쓰다출력 버킷에서 Zencoder에 대한 권한 Zencoder에 작업을 제출하기 전에. 쓰기 권한이 필요한 S3 "경로"가 아니라 S3 버킷입니다. 예를 들어, 자산http://s3.amazonaws.com/my_files/0000/video.mp4 "my_files / 0000"(경로)이 아닌 "my_files"(버킷 이름)에 쓰기 액세스 권한을 추가해야합니다.

URL (? 또는 #)에서 유효하지 않은 특수 문자를 포함하는 키를 만들려면 URL 인코딩 (각각 % 3F 및 % 23)해야합니다. 다른 모든 문자는 URL로 인코딩되어서는 안됩니다.

S3 URL이 사전 서명 된 경우 ( "Signature", "Expires"및 "AWSAccessKeyId"쿼리 파라미터 포함) 모든 문자는 URL 인코딩되어야합니다.

URL의 프로토콜을 다음과 같이 설정하여 S3 버킷의 지역을 제공 할 수 있습니다. s3+region-name , 여기서 "region-name"은 다음과 같이 정의됩니다. 이 문서 . 예를 들어 아시아 태평양 (싱가포르) 리전의 버킷에서 파일에 액세스하려면 URL을s3+ap-southeast-1://my-bucket/file.mp4 .

Azure에 대한 참고 사항 :

URL에 특수 문자를 사용한 인증이 포함 된 경우그들이 제대로 이스케이프되었는지 확인하십시오 .

클라우드 파일에 대한 참고 사항 :

다음과 같이 프로토콜에 추가하여 사용할 지역 (DFW, ORD 또는 UK)을 지정할 수 있습니다. cf+ord://username:api_key@container/object . 현재 지원되는 클라우드 파일 지역은 DFW, ORD 및 영국뿐입니다. 기본적으로 DFW 영역이 사용됩니다.

컨테이너 이름의 모든 특수 문자는 URL로 인코딩되어야 합니다.

Google Cloud Storage에 대한 참고 사항 :

GCS 액세스 키는의 "Interoperable Access"섹션에서 찾을 수 있습니다. Google API 콘솔 . 액세스 키는올바르게 이스케이프해야합니다 .

점이 포함 된 GCS 버킷 이름은 지원되지 않습니다.

Aspera에 대한 참고 사항 :

URL의 ssh-port 부분은 필요하지 않으며 기본값은 22입니다.

Zencoder는 비디오 인코딩 서버에서 Aspera 클라이언트를 실행합니다. Aspera Enterprise 또는 Connect 서버 , 파일을 호스팅합니다.

이는 파일을 사용할 수 있도록 FTP 서버를 실행하고 파일 전송을 위해 FTP 클라이언트를 사용하는 Zencoder와 유사한 상황입니다.

  {
    "input": "http://example.com/path/to/input.avi"
  }

outputs

outputs:Array or Hash

API 버전: V2

유효한 값 : 해시 배열 또는 단일 해시

호환 가능한 작업 유형: 주문형 비디오

예:

"출력": [{}]
"출력": {}

설명:

기본 출력은 다음 설정을 가진 단일 비디오 파일입니다.

H.264 비디오, AAC 오디오, MP4 파일 형식
비디오: 중간 품질
오디오 : 스테레오, 중간 품질 (약 112kbps), 44100Hz

출력 위치를 지정하지 않으면 파일이 Zencoder에서 임시로 호스팅됩니다. 24 시간이 지나면 파일을 더 이상 사용할 수 없습니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "outputs": [
      {
        "url": "s3://my-output-bucket/final-1.mp4"
      },
      {
        "url": "s3://my-output-bucket/final-2.webm"
      }
    ]
  }

region

region:String

API 버전: V2

기본:우리

유효한 값 : us, europe, asia, sa, australia, us-virginia, us-oregon, us-n-california, eu-dublin, asia-singapore, asia-tokyo, sa-saopaulo, australia-sydney, us-central-gce, eu-west-gce 또는 asia-east-gce

호환 가능한 작업 유형: VOD

예:미국-버지니아

설명:

작업 인코딩에 사용할 Amazon AWS 리전을 지정할 수 있으며 지정된 리전의 서버에서 작업을 처리합니다.

대륙 전체 지역 (미국, 유럽, 아시아, sa 또는 오스트레일리아)을 지정할 수 있습니다. 이들 중 하나를 사용하면 대륙 내의 모든 지역을 사용하여 작업을 처리 할 수 있습니다.

보다 구체적인 리전은 us-virginia, us-oregon, us-n-california, eu-dublin, asia-singapore, asia-tokyo, sa-saopaulo 및 australia-sydney와 같은 특정 AWS 리전을 대상으로하는 데 사용할 수 있습니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "region": "us-virginia"
  }

test

test:Boolean

API 버전: V2

기본:그릇된

유효한 값 :참 또는 거짓

호환 가능한 작업 유형: VOD

설명:

작업에 대한 테스트 모드를 활성화합니다 ( "통합 모드"). 통합 모드에서는 모든 인코딩 된 파일이 5 초로 단축되며 작업에 대한 비용이 청구되지 않습니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "test": true
  }

private

private:Boolean

API 버전: V2

기본:그릇된

유효한 값 :참 또는 거짓

호환 가능한 작업 유형: VOD

설명:

개인 정보 보호 모드는 특정 API 매개 변수를 적용하여 무단보기로부터 콘텐츠를 보호하고 잠재적으로 민감한 정보를 난독 화합니다. Zencoder 직원은 어떤 이유로 든 개인 파일을 보지 않습니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "private": true
  }

download_connections

download_connections:Integer

API 버전: V2

기본: 5

유효한 값 : 0에서 25 사이의 정수

호환 작업 유형: VOD

설명:

다운로드에 사용할 연결 수를 지정할 수 있습니다. input파일. 이렇게하면 원격 서버의 대역폭에 따라 다운로드 전송 시간이 빨라질 수 있습니다. 연결 수가 많을수록 서버에 더 많은 부하가 발생할 수 있습니다. 다운로드 시간 초과에 문제가 있거나 Zencoder가 파일을 검색 할 때 너무 많은 대역폭을 사용하지 않도록하려면이 값을 1로 설정하십시오.

  {
    "input": "s3://zencodertesting/test.mov",
    "download_connections": 3
  }

pass_through

pass_through:String

API 버전: V2

유효한 값 : 최대 255 자 문자열입니다.

호환 가능한 작업 유형: VOD

예:내 사용자 지정 통과 값

설명:

이 작업과 함께 저장할 선택적 정보입니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "pass_through": "my-custom-pass-through-value"
  }

mock

mock:Boolean

API 버전: V2

기본:그릇된

유효한 값 :참 또는 거짓

호환 가능한 작업 유형: VOD

설명:

작업 요청을 모의하고 실제로 작업을 생성하지 않고 정상적인 응답을 반환합니다. 작업 및 출력 ID는 null입니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "mock": true
  }

grouping

grouping:String

API 버전: V2

유효한 값 : 모든 문자열.

호환 가능한 작업 유형: VOD

예:내 사용자 지정 통과 값

설명:

보고 목적으로 그룹을 만들기 위해 여기에 임의의 문자열을 전달할 수 있습니다. 이렇게하면 각 그룹에 대한 통계 정보가 수집되어보고 API .

보고서 그룹을 사용하여 각 프로젝트, 클라이언트 또는 부서의 분 사용량을 추적 할 수 있습니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "grouping": "my-custom-pass-through-value"
  }

aspera_transfer_policy

aspera_transfer_policy:String

API 버전: V2

기본:공정한

유효한 값 :보통 또는 낮음

호환 작업 유형: VOD

설명:

Aspera 서버에서 파일을 전송할 때 Zencoder가 인코딩 서버의 사용 가능한 대역폭을 사용하는 방법을 설정합니다.

공정한인코딩 서버에서 실행중인 모든 작업간에 대역폭을 균등하게 분할합니다.

낮은인코딩 서버에서 사용 가능한 대역폭을 사용하지만 다른 작업에 우선 순위를 부여합니다. 낮음은 너무 많은 트래픽으로 서버를 과도하게 실행하는 것이 염려되는 경우 유용합니다.

참고: Aspera의 높음 옵션은 Zencoder에서 지원되지 않습니다. 기본적으로 가능한 한 많은 대역폭을 사용하지만 인코딩 서버의 다른 모든 작업보다 한 작업의 대역폭에 대한 액세스의 우선 순위를 지정하지 않습니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "aspera_transfer_policy": "fair"
  }

또한보십시오: transfer_minimum_rate과transfer_maximum_rate

transfer_minimum_rate

transfer_minimum_rate:Number

API 버전: V2

기본: 1000

유효한 값 : 동방성

호환 작업 유형: VOD

설명:

Aspera로 파일을 전송하는 동안 사용할 전송률 하한선을 설정합니다. 이것은 속도에 도달하는 것을 보장하지는 않지만 대역폭을 사용할 수있는 경우 파일 전송이이 속도 이하로 떨어지지 않습니다.

이보다 작아야합니다. transfer_maximum_rate .

  {
    "input": "s3://zencodertesting/test.mov",
    "transfer_minimum_rate": 2500
  }

또한보십시오: transfer_maximum_rate과aspera_transfer_policy

transfer_maximum_rate

transfer_maximum_rate:String

API 버전: V2

기본: 250000

유효한 값 : 백만원

호환 작업 유형: VOD

설명:

Aspera로 파일을 전송하는 동안 사용할 전송 속도 한도를 설정합니다. 이것은 속도 도달을 보장하지는 않지만 대역폭을 사용할 수있는 경우 파일 전송이이 속도를 초과하지 않습니다.

많은 수의 작업을 동시에 인코딩 할 때 최대 전송 속도를 설정하여 트래픽으로 소스 및 대상 서버에 부담을주지 않도록하는 것이 좋습니다.

이것은보다 커야합니다. transfer_minimum_rate .

  {
    "input": "s3://zencodertesting/test.mov",
    "transfer_maximum_rate": 25000
  }

또한보십시오: transfer_minimum_rate과aspera_transfer_policy

expected_md5_checksum

expected_md5_checksum:String

API 버전: V2

호환 작업 유형: VOD

설명:

입력 파일의 예상 MD5 체크섬입니다. 파일의 체크섬이 제공된 체크섬과 일치하지 않으면 작업이 실패합니다.

  {
    "input": "s3://zencodertesting/test.mov",
    "expected_md5_checksum": "d5ed34b6b49f57a4a5f4be72fc0a2cd4"
  }

credentials

credentials:String

API 버전: V2

호환 작업 유형: VOD

예: ftp_dev_server

설명:

전송에 사용할 저장된 자격 증명의 별명을 참조합니다. 계정 자격 증명 섹션 .

FTP, SFTP, FTPS, S3, GCS 또는 CF에 사용할 수 있습니다.

  {
    "input": "ftp://ftp.example.com/file.mp4",
    "credentials": "ftp_dev_server"
  }

또한보십시오: input