Google AI

Перевод с помощью Google Gemini и Lingo.dev Compiler

Что такое Google AI?

Google AI Studio — это веб-среда разработки для создания, тестирования и развертывания приложений, работающих на основе генеративных моделей ИИ от Google, таких как Gemini. Она позволяет разработчикам экспериментировать с запросами, настраивать ответы и интегрировать модели в приложения через API, всё это в удобном интерфейсе, подключённом к Google Cloud.

Настройка API-ключа

Для работы с Google AI требуется API-ключ для аутентификации запросов от Lingo.dev Compiler. Выберите метод настройки, который лучше всего подходит для вашего рабочего процесса:

Вариант 1: Переменная окружения (терминал)

Лучше всего подходит для быстрых экспериментов и тестирования без изменения файлов.

Установите ключ напрямую в сессии терминала:

export GOOGLE_API_KEY="your-api-key-here"

Этот ключ будет доступен только до закрытия окна терминала.

Вариант 2: Конфигурация проекта (.env)

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

Создайте файл .env в корневой директории вашего проекта:

touch .env

Добавьте следующую строку в файл:

GOOGLE_API_KEY="your-api-key-here"

Lingo.dev Compiler проверяет файлы окружения в следующем порядке приоритета:

  1. .env.development (наивысший приоритет)
  2. .env.local
  3. .env (наименьший приоритет)

Значения в файлах с более высоким приоритетом переопределяют значения в файлах с более низким приоритетом.

Вариант 3: Глобальная конфигурация (настройки пользователя)

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

Создайте файл конфигурации в домашней директории:

touch ~/.lingodotdevrc

Добавьте в файл следующий контент:

[llm]
googleApiKey="your-api-key-here"

Эта конфигурация сохраняется для всех сессий терминала и проектов на вашем компьютере.

Приоритет конфигурации

Когда используются несколько методов конфигурации, Lingo.dev Compiler проверяет API-ключи в следующем порядке:

  1. Переменные окружения (наивысший приоритет)
  2. Файлы .env проекта (в их собственном порядке приоритета)
  3. Файл конфигурации пользователя ~/.lingodotdevrc (наименьший приоритет)

Используется первый найденный действительный API-ключ.

Использование Google AI

Чтобы включить Google AI, установите свойство models в параметрах компилятора:

import react from "@vitejs/plugin-react";
import lingoCompiler from "lingo.dev/compiler";
import { type UserConfig } from "vite";

// https://vite.dev/config/
const viteConfig: UserConfig = {
  plugins: [react()],
};

const withLingo = lingoCompiler.vite({
  sourceRoot: "src",
  lingoDir: "lingo",
  sourceLocale: "en",
  targetLocales: ["es", "fr", "de", "ja"],
  rsc: false,
  useDirective: false,
  debug: false,
  models: {
    "*:*": "google:gemini-1.5-flash",
  },
});

export default withLingo(viteConfig);

Свойство принимает объект, где:

  • ключи — это пары исходного и целевого языков, где * представляет любой язык
  • значения — это идентификаторы моделей (например, google:gemini-1.5-flash)

Вы можете использовать Google AI для перевода:

  • между всеми языками
  • с конкретного исходного языка
  • на конкретный целевой язык
  • между конкретным исходным и целевым языками

Перевод всех языков

Используйте шаблон подстановки *:*, чтобы применить одну и ту же модель Google для всех пар перевода:

const withLingo = lingoCompiler.vite({
  sourceRoot: "src",
  lingoDir: "lingo",
  sourceLocale: "en",
  targetLocales: ["es", "fr", "de", "ja", "pt", "zh"],
  models: {
    // Использовать Gemini 1.5 Flash для всех пар перевода
    "*:*": "google:gemini-1.5-flash",
  },
});

Перевод с конкретного исходного языка

Используйте конкретный исходный язык с подстановочным целевым, чтобы применить модель для всех переводов с этого языка:

const withLingo = lingoCompiler.vite({
  sourceRoot: "src",
  lingoDir: "lingo",
  sourceLocale: "en",
  targetLocales: ["es", "fr", "de", "ja", "pt", "zh"],
  models: {
    // Использовать Gemini 1.5 Pro для всех переводов с английского
    "en:*": "google:gemini-1.5-pro",
    // Использовать Gemini 1.5 Flash для переводов с испанского на любой язык
    "es:*": "google:gemini-1.5-flash",
    // Резерв для других исходных языков
    "*:*": "google:gemini-1.5-flash-latest",
  },
});

Перевод на конкретный целевой язык

Используйте универсальный источник с указанием конкретного целевого языка, чтобы применить модель для всех переводов на этот язык:

const withLingo = lingoCompiler.vite({
  sourceRoot: "src",
  lingoDir: "lingo",
  sourceLocale: "en",
  targetLocales: ["es", "fr", "de", "ja", "pt", "zh"],
  models: {
    // Использовать специализированную модель для переводов на японский
    "*:ja": "google:gemini-1.5-pro",
    // Использовать Gemini 1.5 Flash для переводов на китайский
    "*:zh": "google:gemini-1.5-flash",
    // Использовать Gemini 1.5 Pro для переводов на немецкий
    "*:de": "google:gemini-1.5-pro-latest",
    // По умолчанию для других целевых языков
    "*:*": "google:gemini-1.5-flash",
  },
});

Перевод между конкретными языками

Определите точные пары источник-цель для детального контроля над тем, какая модель обрабатывает определённые языковые комбинации:

const withLingo = lingoCompiler.vite({
  sourceRoot: "src",
  lingoDir: "lingo",
  sourceLocale: "en",
  targetLocales: ["es", "fr", "de", "ja", "pt", "zh"],
  models: {
    // Конкретные пары с оптимальными моделями
    "en:es": "google:gemini-1.5-flash", // с английского на испанский
    "en:ja": "google:gemini-1.5-pro", // с английского на японский
    "en:zh": "google:gemini-1.5-pro", // с английского на китайский
    "es:en": "google:gemini-1.5-flash", // с испанского на английский
    "fr:en": "google:gemini-1.5-flash-latest", // с французского на английский
    "de:en": "google:gemini-1.0-pro", // с немецкого на английский

    // Резерв для неуказанных пар
    "*:*": "google:gemini-1.5-flash",
  },
});