문서 목차

번역 작업 API

번역 작업 생성

/v1/translation/create

문서/파일 번역을 위한 새로운 번역 작업을 생성합니다.

예시

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'file=@bitcoin.pdf' \
4--form 'fromLang=English' \
5--form 'toLang=Simplified Chinese'

요청 매개변수

매개변수유형기본값설명예시
*filebinary-
  • 번역이 필요한 파일
  • 지원 파일 형식: 조회
bitcoin.pdf
*fromLangString-
  • 원본 언어, 원본 언어는 대상 언어와 동일할 수 없습니다
  • 지원 언어: 조회
English
*toLangString-
  • 대상 언어, 대상 언어는 원본 언어와 동일할 수 없습니다
  • 지원 언어: 조회
Simplified Chinese
modelString-
  • 번역용 AI 모델
  • 지원 모델: 조회
-
fileDescriptionString-

문서 설명, 추가 정보를 제공하여 번역 품질을 향상시킵니다. 예를 들어 추가적인 문서 배경 정보 및 기타 번역 요구사항 등을 추가

-
glossaryString-

번역 시 사용된 용어집 이름

-
previewBooleanfalse

미리보기만 생성할지 여부. 미리보기만 생성할 때는 2 credits를 지불하여 문서 번역의 미리보기를 생성합니다

-
shouldTranslateImageBooleanfalse
  • 문서 내 이미지 번역 여부
  • PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF만 지원
-
shouldTranslateFileNameBooleantrue

파일명 번역 여부

-
passwordString-

PDF 파일 열기 비밀번호

-
ignoreCommentsBooleanfalse

DOCX, PPTX, XLSX의 주석 무시 여부

-
ignoreNotesBooleanfalse

PPTX의 노트 무시 여부

-
ignoreHeadersAndFootersBooleanfalse

DOCX의 머리글 및 바닥글 무시 여부

-
ignoreHiddenBooleanfalse

PPTX의 숨겨진 슬라이드 무시 여부

-
ignoreMastersBooleanfalse

PPTX의 마스터 텍스트 무시 여부

-
ignoreSheetNamesBooleanfalse

XLSX의 시트명을 번역하지 않을지 여부

-
webhookUrlString-

상태 업데이트 시 콜백 URL, 콜백 내용 포함: {taskId, progress, status}

-

응답

매개변수유형기본값설명예시
taskIdString-

작업 ID

-
번역 작업 API
번역 작업 조회