문서 목차

번역 작업 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 모델 - 지원 모델: 조회- 翻译的AI模型 - 支持模型:查询- 翻译的AI模型 - 支持模型:查询- 翻译的AI模型 - 支持模型:查询- 翻译的AI模型 - 支持模型:查询
-
fileDescriptionString-

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

-
glossaryString-

번역 시 사용된 용어집 이름

-
previewBooleanfalse

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

-
shouldTranslateImageBooleanfalse
  • 문서 내 이미지 번역 여부 - PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF만 지원- 是否翻译文档中的图片 - 仅支持PDF/DOCX/PPTX/EPUB/ODS/ODT/ODF- 是否翻译文档中的图片 - 仅支持PDF/DOCX/PPTX/EPUB/ODS/ODT/ODF- 是否翻译文档中的图片 - 仅支持PDF/DOCX/PPTX/EPUB/ODS/ODT/ODF- 是否翻译文档中的图片 - 仅支持PDF/DOCX/PPTX/EPUB/ODS/ODT/ODF
-
shouldTranslateFileNameBooleantrue

파일명 번역 여부

-
passwordString-

PDF 파일 열기 비밀번호

-
ignoreCommentsBooleanfalse

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

-
ignoreNotesBooleanfalse

PPTX의 노트 무시 여부

-
ignoreHeadersAndFootersBooleanfalse

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

-
ignoreHiddenBooleanfalse

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

-
ignoreMastersBooleanfalse

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

-
ignoreSheetNamesBooleanfalse

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

-
extractTextRegExpPatternString-
  • 정규 표현식과 일치하는 콘텐츠만 번역하고, 이를 번역문으로 교체 - txt만 지원- 仅翻译匹配正则表达式的内容,并将其替换为译文 - 仅支持txt- 仅翻译匹配正则表达式的内容,并将其替换为译文 - 仅支持txt- 仅翻译匹配正则表达式的内容,并将其替换为译文 - 仅支持txt- 仅翻译匹配正则表达式的内容,并将其替换为译文 - 仅支持txt
-
extractTextRegExpFlagsString-
  • 정규 표현식의 Flags: g, s, m, u, y - txt만 지원- 正则表达式的Flags:g、s、m、u、y - 仅支持txt- 正则表达式的Flags:g、s、m、u、y - 仅支持txt- 正则表达式的Flags:g、s、m、u、y - 仅支持txt- 正则表达式的Flags:g、s、m、u、y - 仅支持txt
-
webhookUrlString-

상태 업데이트 시 콜백 URL, 콜백 내용에는 다음이 포함됩니다: {taskId, progress, status}

-

응답

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

작업 ID

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