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 | - | Общее количество Credits, необходимых для перевода | - |
| usedCredits | Integer | - | Количество кредитов, использованных задачей перевода | - |
Распространенные ошибки
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.