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.