번역 작업 API
번역 텍스트
텍스트를 번역하고 번역 결과를 동시에 반환합니다.
- 전체 주소
- https://otranslator.com/api/v1/translation/translateTexts
- 인증
- Authorization 요청 헤더에 API Key를 전달해야 합니다
- Content-Type
- application/json
- 잘못된 형식
- { "error": "Invalid API key." }
주의사항
이 인터페이스는 전달된 텍스트를 JSON 문서로 임시 저장하고 동기 처리하며, 소량 텍스트의 즉시 번역에 적합합니다.
계정 포인트 잔액이 최소 2 credits 필요합니다. 실제 비용이 잔액을 초과하면 인터페이스가 taskId와 price를 반환하고 잔액 부족을 알립니다.
예시
1curl -X POST 'https://otranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "texts": [
6 "string"
7 ],
8 "fromLang": "[string]",
9 "toLang": "[string]"
10}'요청 매개변수
응답
| 매개변수 | 유형 | 기본값 | 설명 | 예시 |
|---|---|---|---|---|
| taskId | String | - | 작업 ID | - |
| translatedTexts | String[] | - | 번역된 텍스트 | - |
| price | Integer | - | 전체 번역에 필요한 Credits 수 | - |
| usedCredits | Integer | - | 번역 작업 사용 Credits 수 | - |
일반적인 오류
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 translate the texts.
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 Missing required parameter: texts.
Provide a non-empty texts array.
400 Failed to translate texts.
The text translation task could not be processed.