Справочник API

Переводит текст на изображении с сохранением исходной вёрстки и отрисовывает результат поверх картинки.

Быстрый старт

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

Аутентификация

Передавайте API-ключ в каждом запросе через заголовок Authorization как Bearer-токен:

Authorization: Bearer YOUR_KEY

API-ключ — случайная 32-байтовая строка с префиксом sk_imagetranslate_. Относитесь к нему как к паролю: храните в серверном секрет-менеджере, не коммитьте в репозиторий и не раскрывайте во фронтенд-коде.

Идемпотентность

Если повторяете запрос после сетевого таймаута, отправьте тот же заголовок Idempotency-Key, чтобы избежать двойного списания кредитов:

Idempotency-Key: <your-uuid>

• Первый вызов с указанным ключом: обрабатывается обычным образом.
• Повторный вызов с тем же ключом (в рамках одного API-ключа): возвращает 409 Conflict и исходный recordId. Повтор не списывает кредит.
• Разные ключи — разные вызовы.

Сгенерируйте ключ на клиенте (подойдёт UUIDv4). Без него каждый повтор списывает новый кредит и снова запускает Torii.

Перевод изображения

Синхронный эндпоинт. Возвращает переведённое изображение в base64 с префиксом data:image/png;base64,.

Base URL

https://api.imagetranslate.ai

Тело запроса

Ответ

Примеры

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer $IMAGETRANSLATE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "YOUR_BASE64_IMAGE",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

Пример ответа

{
  "success": true,
  "recordId": "Z3l4abc...",
  "resultImage": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
  "remainingCredit": 9990
}

Коды ошибок

Формат ответа об ошибке

• 4xx / 500: { "detail": "<message>" }
• 422: { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] }
• 409: { "error": "idempotency_replay", "recordId": "<id>", "message": "..." }

Лимиты запросов

Считаются на каждый API-ключ в минуту и зависят от тарифа:

Нужен лимит выше — напишите на [email protected].

Тарификация

10 advanced credit за вызов. Подробности о тарифах и пакетах — на странице тарифов.

Приложение

Коды языков

В sourceLanguage укажите код ISO 639-1 / BCP-47 либо auto для автоопределения. В targetLanguage — те же коды, кроме auto.

Часто используемые коды:

Значения mode

Параметр mode задаёт стиль отрисовки. Подбирайте под содержимое изображения.

Модели translator

Параметр translator выбирает AI-модель, выполняющую перевод. Любая модель — 10 кредитов за вызов.

• Grok (по умолчанию)
• Gemini
• Deepseek
• ChatGPT
• Claude

Начало работы

Готовы интегрировать? Создайте первый API-ключ →