미디어 변환 선택
Transform Media Item에 transformation 객체를 보내 작업을 시작합니다. 응답의 jobId로 상태를 조회하고 SUCCESSFUL이면 결과 콘텐츠를 받습니다. PENDING 상태에서 결과를 요구하거나 실패한 작업의 결과를 요구하면 오류가 발생합니다.
변환 종류
transformation.type | 처리 대상과 결과 | 전체 매개변수 |
|---|---|---|
image | 이미지에 회전, 크기 조절, 암호화, 주석 등의 작업을 순서대로 적용 | 이미지 |
imageToDocument | 이미지를 PDF로 변환 | 이미지 |
dicomToImage | DICOM의 레이어를 이미지로 렌더링 | DICOM |
imageToEmbedding | 이미지의 벡터 임베딩 생성 | 임베딩 |
videoToAudio | 비디오의 첫 오디오 스트림 추출 | 오디오와 비디오 |
audioToText | 음성 전사 또는 파형 데이터 생성 | 오디오와 비디오 |
videoToArchive | 장면 프레임 이미지를 TAR로 추출 | 오디오와 비디오 |
videoToText | 장면 프레임의 타임스탬프 목록 추출 | 오디오와 비디오 |
videoToImage | 첫 장면 또는 지정 시각의 프레임 추출 | 오디오와 비디오 |
video | 비디오 재인코딩 또는 조각 선택 | 오디오와 비디오 |
audio | 채널 선택, 조각 선택 또는 형식 변환 | 오디오와 비디오 |
documentToDocument | PDF 변환 또는 PDF 페이지 범위 선택 | 문서 |
documentToImage | PDF 페이지를 이미지로 렌더링 | 문서 |
imageToText | 이미지의 OCR 또는 구조화된 텍스트 추출 | 텍스트 추출 |
documentToText | 문서의 목차, 텍스트, 폼 필드 또는 VLM 기반 내용 추출 | 텍스트 추출 |
emailToText | 이메일 본문 추출 | 이메일 |
emailToAttachment | 이메일 첨부파일의 바이트 추출 | 이메일 |
spreadsheetToText | 이름으로 선택한 시트를 JSON으로 변환 | 스프레드시트 |
요청 구성
최상위 transformation과 선택한 operation 또는 각 operations 항목은 type으로 분기를 구분합니다. encoding은 출력 인코딩을, OCR과 음성 전사의 언어는 언어 및 문자 체계 값을 따릅니다.
다음은 800×600 크기의 WebP를 요청하는 가상 설정입니다. 대상 미디어 집합과 항목은 HTTP 경로에서 지정합니다.
{
"transformation": {
"type": "image",
"encoding": { "type": "webp" },
"operations": [
{ "type": "resize", "width": 800, "height": 600 }
]
}
}
원래 가로세로 비율을 유지해야 한다면 resize의 너비와 높이 중 하나만 지정하거나 경계 상자에 맞추는 작업을 사용합니다. 페이지 번호, 타임스탬프, 조각 길이는 작업마다 기준과 단위가 다르므로 해당 변환의 조건을 확인합니다.