API задач перевода
Перезапустить задачу перевода
Для перезапуска завершенных задач или оплаты баллов для выполнения полного перевода текста
- Полный адрес
- https://otranslator.com/api/v1/translation/start
- Аутентификация
- Необходимо передать API Key в заголовке запроса Authorization
- Content-Type
- application/json
- Ошибочный формат
- { "error": "Invalid API key." }
Меры предосторожности
Этот интерфейс может использоваться для перезапуска задач со статусом Terminated, а также для оплаты через payWithCredits и запуска полного перевода после завершения предварительного просмотра задачи.
За оплаченные задачи плата повторно не взимается. При передаче параметра model используется для пересчета стоимости только если payWithCredits равен true и задача еще не оплачена.
Пример
1curl -X POST 'https://otranslator.com/api/v1/translation/start' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'Параметры запроса
| Параметры | Тип | По умолчанию | Описание | Пример |
|---|---|---|---|---|
| *taskId | String | - | ID задачи перевода | - |
| payWithCredits | Boolean | - | Оплачивать ли задачу перевода - действует только для неоплаченных документов, за уже оплаченные документы повторная плата не взимается | - |
| model | String | - |
| - |
Ответ
| Параметры | Тип | По умолчанию | Описание | Пример |
|---|---|---|---|---|
| success | Boolean | - | Успешно ли запущено | - |
Распространенные ошибки
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.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
402 Insufficient credits balance.
The account does not have enough credits to start the full translation.
404 Task not found.
The task does not exist or does not belong to the current API account.