문서 목차

번역 작업 API

번역 작업 생성

POST/v1/translation/create

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

전체 주소
https://otranslator.com/api/v1/translation/create
인증
Authorization 요청 헤더에 API Key를 전달해야 합니다
Content-Type
multipart/form-data
잘못된 형식
{ "error": "Invalid API key." }

주의사항

작업을 생성하면 즉시 대기 큐에 진입하고 taskId를 반환합니다. 이후 작업 조회 인터페이스를 통해 진행 상황, 비용 및 다운로드 링크를 얻을 수 있습니다.

계정 포인트 잔액이 최소 2 credits 필요해야 작업을 생성할 수 있습니다. preview가 true일 때 미리보기만 생성하고 미리보기 포인트만 지불합니다.

glossary 매개변수는 용어집 이름으로 매칭되며, 여러 용어집을 지정하기 위해 동일한 이름의 필드를 중복하여 여러 개 전달할 수 있습니다.

예시

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' \
6--form 'outputFormat=MD' \
7--form 'bilingualMode=Horizontal'

요청 매개변수

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

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

-
glossaryString-

번역 시 사용된 용어집 이름

-
previewBooleanfalse

미리보기만 생성 여부미리보기만 생성 시, 2 credits 지불로 문서 번역 미리보기를 생성합니다

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

문서 내용 인식에 OCR을 강제로 사용할지 여부입니다. 활성화 시 이미지 번역도 함께 활성화됩니다.

-
shouldTranslateFileNameBooleantrue

파일명 번역 여부

-
strictSourceLanguageCheckBooleanfalse

원어로 인식된 텍스트만 번역할지 여부. 켜면 원어가 아닌 콘텐츠를 더 엄격하게 필터링하며, 비용 계산에도 더 엄격한 계수를 사용합니다.

-
outputFormatString-

출력 형식. MD를 전달하면 Markdown 역문 생성을 시도합니다.

MD
bilingualModeStringHorizontal

이중 언어 파일 정렬 방향. Horizontal은 좌우 대조를 나타내며, Vertical은 상하 대조를 나타냅니다.

Horizontal
passwordString-

PDF 파일 열기 비밀번호

-
ignoreCommentsBooleanfalse

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

-
ignoreNotesBooleanfalse

PPTX의 발표자 노트 무시 여부

-
ignoreHeadersAndFootersBooleanfalse

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

-
ignoreHiddenBooleanfalse

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

-
ignoreMastersBooleanfalse

PPTX의 슬라이드 마스터 텍스트 무시 여부

-
ignoreSheetNamesBooleanfalse

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

-
extractTextRegExpPatternString-
  • 정규식과 일치하는 내용만 번역하여 번역문으로 대체
  • txmsg만 지원
-
extractTextRegExpFlagsString-
  • 정규표현식의 Flags: g, s, m, u, y
  • txmsg만 지원
-
allowFlipBooleantrue

오른쪽에서 왼쪽으로 쓰는 언어의 페이지 레이아웃 반전 허용 여부. false 전달 시 이미지 반전도 함께 비활성화됩니다.

-
allowFlipImageBooleantrue

오른쪽에서 왼쪽으로 쓰는 언어의 이미지 콘텐츠 반전 허용 여부.

-
webhookUrlString-

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

-

응답

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

작업 ID

-

일반적인 오류

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

402 Insufficient credits balance.

The account does not have enough credits to create the task.

400 Missing required parameter: fromLang.

Provide fromLang using a language returned by /api/v1/languages.

400 Missing required parameter: toLang.

Provide toLang using a language returned by /api/v1/languages.

400 Invalid fromLang: [language]. Use a language returned by /api/v1/languages.

The provided source language is not supported.

400 Invalid toLang: [language]. Use a language returned by /api/v1/languages.

The provided target language is not supported.

400 Missing required file upload: file.

Upload the source document in the file form field.

404 Glossary "[name]" not found.

The specified glossary does not exist or does not belong to the current API account.

번역 작업 API
번역 작업 조회