Gemini 번역

Gemini를 디렉티브 @strTranslate의 번역 공급자로 사용하여 필드 값을 원하는 언어로 번역합니다.

설명

GeminiAPI를 디렉티브 @strTranslate의 번역 공급자로 사용할 수 있도록 합니다.

String 타입의 임의 필드에 디렉티브 @strTranslate를 추가하면 원하는 언어로 번역할 수 있습니다.

예를 들어, 다음 쿼리는 Gemini API를 사용하여 게시물의 title 필드와 content 필드를 영어에서 프랑스어로 번역합니다:

{
  posts {
    title @strTranslate(
      from: "en",
      to: "fr",
      provider: gemini
    )
    
    content @strTranslate(
      from: "en",
      to: "fr",
      provider: gemini
    )
  }
}

Google 인증

Gemini를 사용하려면 설정 페이지의 「Plugin Management => Gemini Translation」 탭에서 Google API 키를 제공해야 합니다.

API 키는 Google AI Studio 계정에서 생성하세요.

그런 다음 아래 방법 중 하나를 따라 값을 입력하세요.

설정에서 입력

설정 페이지의 해당 입력란에 API 키를 입력하고 「Save Changes (All)」을 클릭합니다:

WordPress 7.0+ 에서는 플러그인 설정 필드가 비어 있으면 Settings > Connectors에 있는 WordPress AI Connectors에서 API 키를 가져옵니다.

`wp-config.php`에 추가

wp-config.php에 상수 GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_GOOGLE_API_KEY를 추가합니다:

define( 'GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_GOOGLE_API_KEY', '{your API key}' );

환경 변수로 설정

환경 변수 GEMINI_TRANSLATION_SERVICES_GOOGLE_API_KEY를 정의합니다.

Gemini 모델

번역 실행에 사용할 Gemini 모델을 커스터마이즈할 수 있습니다.

지원되는 모델은 다음과 같습니다:

Gemini 2.0 Flash (gemini-2.0-flash)
Gemini 2.0 Flash-Lite (gemini-2.0-flash-lite)
Gemini 2.5 Flash (gemini-2.5-flash)
Gemini 2.5 Flash-Lite (gemini-2.5-flash-lite)
Gemini 2.5 Pro (gemini-2.5-pro)
Gemini 3.1 Flash-Lite (gemini-3.1-flash-lite)

아래 방법 중 하나를 따라 값을 입력하세요.

설정에서 입력

설정 페이지의 해당 입력란에 모델을 입력하고 「Save Changes (All)」을 클릭합니다:

`wp-config.php`에 추가

wp-config.php에 상수 GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_MODEL을 추가합니다:

define( 'GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_MODEL', 'gemini-2.5-flash' );

환경 변수로 설정

환경 변수 GEMINI_TRANSLATION_SERVICES_MODEL을 정의합니다.

번역 프롬프트

번역 실행을 위해 Gemini에 전달할 프롬프트를 커스터마이즈할 수 있습니다.

아래 방법 중 하나를 따라 값을 입력하세요.

설정에서 입력

설정 페이지의 해당 입력란에 「System message」와 「Prompt template」을 입력하고 「Save Changes (All)」을 클릭합니다:

`wp-config.php`에 추가

wp-config.php에 상수 GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_SYSTEM_MESSAGE와 GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_PROMPT_TEMPLATE을 추가합니다:

define( 'GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_SYSTEM_MESSAGE', 'You are a helpful translator' );
define( 'GATOGRAPHQL_GEMINI_TRANSLATION_SERVICES_PROMPT_TEMPLATE', 'Please translate strings from {$sourceLang} to {$targetLang}' );

환경 변수로 설정

환경 변수 GEMINI_TRANSLATION_SERVICES_SYSTEM_MESSAGE와 GEMINI_TRANSLATION_SERVICES_PROMPT_TEMPLATE을 정의합니다.