문서 목차

번역 생성

번역 작업을 생성합니다.

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

요청 매개변수

지원 언어:
English、Simplified Chinese、Traditional Chinese (Hong Kong)、Traditional Chinese (Taiwan)、Traditional Chinese、British English、Spanish、Portuguese、Russian、Italian、French、German、Ukrainian、Swedish、Japanese、Japanese (Honorifics)、Japanese (Humble)、Japanese (Polite)、Polish、Turkish、Korean、Malay、Lao、Thai、Vietnamese、Bengali、Burmese、Finnish、Georgian、Greek、Albanian、Arabic、Armenian、Azerbaijani、Belarusian、Bosnian、Bulgarian、Canadian French、Catalan、Croatian、Czech、Danish、Dutch、Estonian、Filipino、Gujarati、Haitian Creole、Hebrew、Hindi、Hungarian、Icelandic、Indonesian、Javanese、Irish、Kazakh、Khmer、Latin、Latin American Spanish、Brazilian Portuguese、Latvian、Lithuanian、Macedonian、Maltese、Mongolian (Cyrillic)、Montenegrin、Norwegian、Persian、Romanian、Serbian (Cyrillic letters)、Serbian (Latin letters)、Sinhala、Slovak、Slovenian、Swahili、Tamil、Telugu、Oriya、Kannada、Punjabi、Marathi、Malayalam、Uzbek、Urdu、Amharic、Uyghur、Cantonese、Yiddish、Tigrinya、Turkmen (Latin letters)、Turkmen (Cyrillic letters)、Any Language

매개변수유형설명
*fromLangString원본 언어, 원본 언어는 대상 언어와 동일할 수 없습니다. 지원되는 언어를 참조하세요
*toLangString대상 언어, 대상 언어는 원본 언어와 동일할 수 없습니다. 지원 언어 참조
*modelString선택 가능한 모델: gemini-2.0-flash | gemini-pro | gemini-2.5-pro | claude-haiku | claude-3.7-sonnet | gpt-4.1-mini | gpt-4.1 | o4-mini | deepseek-v3 | deepseek-r1 | grok-3-mini | grok-3 | llama-4-maverick
*filebinary번역이 필요한 파일,지원 파일 유형: .PDF .DOCX .XLSX .PPTX .EPUB .PO .SRT .TXT .HTML .ZIP .XML .XLF .GO .JPG .JPEG .PNG .MD .ODT .ODS .ODP .CSV .TSV .YAML .PHP .AI
shouldTranslateImageString유효값: "true" 또는 "false". PDF 문서의 이미지를 번역할지 여부, 기본값은 false
glossaryString번역 시 사용된 용어집 이름
previewString유효값: "true" 또는 "false". 2 credits를 지불하여 문서 번역 미리보기 생성

응답

매개변수유형설명
taskIdString생성된 작업의 id

번역 조회

번역 작업 조회, 작업 상태 및 번역된 파일 링크 포함

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data  '{ "taskId": "[created taskId]" }'

요청 매개변수

매개변수유형설명
*taskIdString번역 작업 ID

응답

매개변수유형설명
statusString'Waiting' | 'Processing' | 'Completed' | 'Terminated'
progressinteger0~100, 번역 작업 진행 상황
translatedFileUrlString번역 파일 다운로드 링크, 번역이 완료되었을 때만(status ='Completed') 유효함
translatedBilingualFileUrlString번역된 이중 언어 파일 다운로드 링크는 번역이 완료되었을 때만(status ='Completed') 유효합니다
usedCreditsinteger번역에 사용된 크레딧
tokenCountinteger문서 내 텍스트에 해당하는 토큰 수
glossaryString[]문서에 사용된 용어집 이름

번역 삭제

번역 작업 및 관련 문서 삭제. API로 생성된 번역 작업은 7일 후 자동으로 삭제됩니다.

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/delete' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data  '{ "taskId": "[created taskId]" }'

요청 매개변수

매개변수유형설명
*taskIdString삭제가 필요한 번역 작업 ID
이전 단계
개발자 등록
다음 단계
쿼리 텍스트