오디오와 비디오 변환

비디오에서 오디오를 추출하는 extractAudio는 첫 번째 오디오 스트림을 변경 없이 가져옵니다. 결과 인코딩은 작업에 맞는 오디오 형식으로 지정합니다.

음성 전사는 language를 생략하면 처음 30초로 언어를 감지합니다. 화자 구분인 diarize는 기본적으로 꺼져 있으며 MORE_ECONOMICAL에서는 지원하지 않습니다. plainTextNoSegmentData를 선택하면 addTimestamps를 명시해야 합니다.

extractFramesAtTimestamps는 이름과 달리 이 요청에서 단일 timestamp를 받습니다. 단위는 초입니다. 오디오와 비디오 조각의 길이는 밀리초이고, chunkIndex로 반환할 조각을 지정합니다. 비디오의 마지막 조각은 지정한 길이보다 짧을 수 있습니다.

각 분기의 객체를 변환 요청의 transformation 값으로 사용합니다. type으로 분기를 선택한 다음 해당 분기의 필수 필드를 제공합니다.

변환 `videoToAudio`

비디오에서 오디오를 추출합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `videoToAudio`.	`videoToAudio`
`encoding`	`union<mp3, wav, ts>`	필수	오디오 결과의 인코딩 형식입니다.
`operation`	`union<extractAudio>`	필수	비디오에서 오디오를 추출할 작업입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `extractAudio`.	`extractAudio`

변환 `audioToText`

오디오를 텍스트로 변환합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `audioToText`.	`audioToText`
`operation`	`union<transcribe, waveform>`	필수	오디오에서 텍스트를 추출할 작업입니다.

`operation`의 구조

분기 `transcribe`

음성을 텍스트로 전사합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `transcribe`.	`transcribe`
`language`	`enum`	선택	음성 전사에 사용할 언어입니다. 생략하면 처음 30초의 오디오로 언어를 자동 감지합니다. 허용값은 음성 전사 언어를 따릅니다.
`diarize`	`boolean`	선택	화자를 구분할지 지정합니다. 기본값은 `false`이며 `MORE_ECONOMICAL` 모드에서는 지원하지 않습니다.
`outputFormat`	`union<plainTextNoSegmentData, json, pttml>`	선택	전사 결과의 출력 형식입니다.
`performanceMode`	`enum`	선택	전사의 성능 모드입니다. 허용값: `MORE_ECONOMICAL`, `MORE_PERFORMANT`.

`outputFormat`의 구조

분기 `plainTextNoSegmentData`

일반 텍스트 형식의 전사 결과입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `plainTextNoSegmentData`.	`plainTextNoSegmentData`
`addTimestamps`	`boolean`	필수	출력에 타임스탬프를 포함할지 지정합니다.

분기 `json`

JSON 형식의 전사 결과입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `json`.	`json`

분기 `pttml`

PTTML(Palantir Timed Text Markup Language) 형식의 전사 결과입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `pttml`.	`pttml`

분기 `waveform`

오디오 파형을 표시할 데이터를 생성합니다. 진폭을 나타내는 0부터 1까지의 정규화된 double 값들을 JSON으로 반환합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `waveform`.	`waveform`
`peaksPerSecond`	`integer`	필수	초당 피크 수이며 범위는 1부터 1000까지입니다.

변환 `videoToArchive`

비디오 프레임을 아카이브로 추출합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `videoToArchive`.	`videoToArchive`
`encoding`	`union<tar>`	필수	아카이브 결과의 인코딩 형식입니다.
`operation`	`union<extractSceneFrames>`	필수	비디오 프레임을 아카이브로 변환할 작업입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `extractSceneFrames`.	`extractSceneFrames`
`encoding`	`union<jpg, tiff, png, webp>`	필수	이미지 결과의 인코딩 형식입니다.
`sceneScore`	`enum`	선택	장면 감지의 민감도입니다. 허용값: `MORE_SENSITIVE`, `STANDARD`, `LESS_SENSITIVE`.

`encoding`의 구조

필드는 공통 이미지 인코딩을 따릅니다.

변환 `videoToText`

비디오의 메타데이터를 텍스트 또는 JSON으로 추출합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `videoToText`.	`videoToText`
`operation`	`union<getTimestampsForSceneFrames>`	필수	비디오에서 텍스트 정보를 추출할 작업입니다.

`operation`의 구조

분기 `getTimestampsForSceneFrames`

비디오 장면 프레임의 타임스탬프 목록을 JSON으로 반환합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `getTimestampsForSceneFrames`.	`getTimestampsForSceneFrames`
`sceneScore`	`enum`	선택	장면 감지의 민감도입니다. 허용값: `MORE_SENSITIVE`, `STANDARD`, `LESS_SENSITIVE`.

변환 `videoToImage`

비디오 프레임을 이미지로 추출합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `videoToImage`.	`videoToImage`
`encoding`	`union<jpg, tiff, png, webp>`	필수	이미지 결과의 인코딩 형식입니다.
`operation`	`union<extractFirstFrame, extractFramesAtTimestamps>`	필수	비디오에서 이미지를 추출할 작업입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `extractFirstFrame`.	`extractFirstFrame`
`height`	`integer`	선택	원하는 높이이며 단위는 픽셀입니다.
`width`	`integer`	선택	원하는 너비이며 단위는 픽셀입니다.

분기 `extractFramesAtTimestamps`

지정한 시각의 비디오 프레임을 추출합니다. 너비와 높이 중 하나만 지정하면 비율을 유지하도록 나머지를 계산합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `extractFramesAtTimestamps`.	`extractFramesAtTimestamps`
`height`	`integer`	선택	원하는 높이이며 단위는 픽셀입니다.
`width`	`integer`	선택	원하는 너비이며 단위는 픽셀입니다.
`timestamp`	`double`	필수	초 단위 타임스탬프입니다.

변환 `video`

비디오 항목을 변환합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `video`.	`video`
`encoding`	`union<mp4, mov, mkv, ts>`	필수	비디오 결과의 인코딩 형식입니다.
`operation`	`union<transcode, chunk>`	필수	비디오에 적용할 작업입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `transcode`.	`transcode`

분기 `chunk`

지정한 길이로 비디오를 나눕니다. 마지막 조각은 지정한 길이보다 짧을 수 있습니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `chunk`.	`chunk`
`chunkDurationMilliseconds`	`integer`	필수	조각 하나의 길이이며 단위는 밀리초입니다.
`chunkIndex`	`integer`	필수	선택할 조각의 인덱스입니다.

변환 `audio`

오디오 항목을 변환합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `audio`.	`audio`
`operation`	`union<channel, chunk, convert>`	필수	오디오에 적용할 작업입니다.

`operation`의 구조

분기 `channel`

여러 채널의 오디오에서 특정 채널을 선택합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `channel`.	`channel`
`encodeFormat`	`union<mp3, wav, ts>`	필수	오디오 결과의 인코딩 형식입니다.
`channel`	`integer`	필수	선택할 채널 번호입니다.

`encodeFormat`의 구조

필드는 공통 오디오 인코딩을 따릅니다.

분기 `chunk`

지정한 길이로 오디오를 나눕니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `chunk`.	`chunk`
`chunkDurationMilliseconds`	`integer`	필수	조각 하나의 길이이며 단위는 밀리초입니다.
`encodeFormat`	`union<mp3, wav, ts>`	필수	오디오 결과의 인코딩 형식입니다.
`chunkIndex`	`integer`	필수	선택할 조각의 인덱스입니다.

`encodeFormat`의 구조

필드는 공통 오디오 인코딩을 따릅니다.

분기 `convert`

오디오를 지정한 형식으로 변환합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `convert`.	`convert`
`encodeFormat`	`union<mp3, wav, ts>`	필수	오디오 결과의 인코딩 형식입니다.

`encodeFormat`의 구조

필드는 공통 오디오 인코딩을 따릅니다.

팔란티어 플랫폼 한국어 해설

오디오와 비디오 변환

변환 `videoToAudio`

`encoding`의 구조

`operation`의 구조

분기 `extractAudio`

변환 `audioToText`

`operation`의 구조

분기 `transcribe`

`outputFormat`의 구조

분기 `plainTextNoSegmentData`

분기 `json`

분기 `pttml`

분기 `waveform`

변환 `videoToArchive`

`encoding`의 구조

`operation`의 구조

분기 `extractSceneFrames`

`encoding`의 구조

변환 `videoToText`

`operation`의 구조

분기 `getTimestampsForSceneFrames`

변환 `videoToImage`

`encoding`의 구조

`operation`의 구조

분기 `extractFirstFrame`

분기 `extractFramesAtTimestamps`

변환 `video`

`encoding`의 구조

`operation`의 구조

분기 `transcode`

분기 `chunk`

변환 `audio`

`operation`의 구조

분기 `channel`

`encodeFormat`의 구조

분기 `chunk`

`encodeFormat`의 구조

분기 `convert`

`encodeFormat`의 구조

Keyboard shortcuts

팔란티어 플랫폼 한국어 해설