Настройка Cloud Vision API

Инструкция по получению бесплатного API-ключа для русского языка

Первые 1000 сканирований в месяц всегда бесплатны. Этого достаточно для обычного использования.

Не передавайте ваш API-ключ другим людям. Любое использование ключа будет учитываться в вашем лимите и может привести к списанию средств.

Почему это нужно?

Встроенное распознавание текста на устройстве не поддерживает кириллицу. Для работы с русским языком используется облачный сервис Google Cloud Vision, который требует личного API-ключа.

Инструкция

Войдите в Google Cloud Console

Перейдите на console.cloud.google.com и войдите с вашим Google-аккаунтом.

Если у вас нет аккаунта Google, создайте его бесплатно.

Создайте новый проект

В верхней панели нажмите на выпадающий список проектов и выберите "New Project" (Новый проект).

Введите любое название, например exile-companion, и нажмите "Create".

Включите Cloud Vision API

В меню слева выберите "APIs & Services" → "Library".

В поиске введите Cloud Vision API и откройте его.

Нажмите кнопку "Enable" (Включить).

Настройте биллинг

Google требует активный платёжный аккаунт для использования Cloud Vision, даже для бесплатного уровня. Средства не будут списаны, пока вы не превысите лимит в 1000 сканирований в месяц.

  1. Перейдите в Billing в Google Cloud Console
  2. Если у вас нет платёжного аккаунта, нажмите "Create account"
  3. Введите название аккаунта и выберите страну, затем нажмите "Continue"
  4. Добавьте способ оплаты (банковская карта), затем нажмите "Submit and enable billing"
  5. Перейдите на вкладку "My projects", найдите ваш проект
  6. Нажмите на меню Actions (⋮) → "Change billing"
  7. Выберите платёжный аккаунт и нажмите "Set account"

Создайте API-ключ

Перейдите в "APIs & Services" → "Credentials".

Нажмите "+ Create Credentials" → "API Key".

Ключ будет создан и показан на экране. Скопируйте его.

Вставьте ключ в приложение

Откройте Exile Companion и выберите русский язык.

В появившемся окне вставьте скопированный API-ключ и нажмите "Сохранить".

Готово! Теперь вы можете сканировать предметы на русском языке.

Часто задаваемые вопросы

Сколько это стоит?

Первые 1000 распознаваний в месяц — бесплатно. Для большинства игроков этого более чем достаточно. После лимита — $1.50 за 1000 распознаваний.

Безопасно ли это?

Да. Ваш API-ключ хранится только на вашем устройстве. Мы не имеем доступа к вашему ключу или аккаунту Google.

Могу ли я использовать один ключ на нескольких устройствах?

Да, вы можете использовать один и тот же ключ на всех ваших устройствах. Лимит 1000 запросов общий для всех устройств.

Как удалить ключ?

В приложении откройте Настройки → в разделе Cloud Vision API нажмите "Удалить API-ключ".

Как проверить использование?

Перейдите в Google Cloud Console → "APIs & Services" → "Dashboard", чтобы посмотреть статистику использования.

Забыли ключ или нужен новый?

В Google Cloud Console → "APIs & Services" → "Credentials" вы можете просмотреть существующие ключи или создать новый.

Решение проблем

Ошибка "API access denied"

Если вы видите эту ошибку, проверьте следующее:

  1. Включён ли Cloud Vision API? (Шаг 3)
  2. Настроен ли биллинг и привязан ли он к вашему проекту? (Шаг 4)
  3. Нет ли на вашем API-ключе ограничений, блокирующих Cloud Vision?