API завдання перекладу
Перекласти текст
Перекладіть текст і отримайте результати перекладу синхронно.
- Повна адреса
- https://otranslator.com/api/v1/translation/translateTexts
- Аутентифікація
- Потрібно передати API Key у заголовку запиту Authorization
- 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}'Параметри запиту
| Параметри | Тип | За замовчуванням | Опис | Приклад |
|---|---|---|---|---|
| *texts | String[] | - | Текст для перекладу | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| model | String | - |
| - |
| fileDescription | String | - | Опис документа: надання додаткової інформації для підвищення якості перекладу, наприклад, додавання фонової інформації про документ та інших вимог до перекладу тощо | - |
Відповідь
| Параметри | Тип | За замовчуванням | Опис | Приклад |
|---|---|---|---|---|
| taskId | String | - | ID завдання | - |
| translatedTexts | String[] | - | Перекладений текст | - |
| price | Integer | - | Загальна кількість кредитів, необхідних для перекладу | - |
| 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.