Vertimo paslaugų teikėjai

Visiškai suderinamas su ankstesnėmis versijomis: provider numatytoji azure, todėl esamos "Azure" darbo eigos veikia nepakitusios – nereikia redaguoti.

Teikėjo pasirinkimas

Nustatykite provider įvestį į azure (numatytasis), aws arba google, tada pateikite to teikėjo kredencialus. Vienam veiksmo iškvietimui naudojamas tik vienas teikėjas; veiksmas deterministiškai deleguoja atitinkamą SDK už gamyklos.

Paslaugų teikėjų palyginimas

Azure AI Translator (numatytasis)

Numatytasis teikėjas. Konfigūruokite "Azure AI Translator" išteklius ir perduokite subscriptionKey, endpoint ir pasirinktinai region. Tai ta pati konfigūracija, kurią jau naudoja esamos darbo eigos.

Official Azure docs

• Azure Translator documentation
• Translate API reference
• Custom Translator overview
• Language support

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            azure:
              subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
              endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
              region: ${{ secrets.TRANSLATOR_REGION }}
          sourceLocale: en
          toLocales: '["es","fr","de"]'

AWS vertimas

Naudoja @aws-sdk/client-translate. Pirmenybę teikite OIDC per aws-actions/configure-aws-credentials kad nebūtų saugomos ilgaamžės paslaptys – veiksmas nuskaito numatytąją AWS SDK kredencialų grandinę. Arba perduokite awsAccessKeyId ir awsSecretAccessKey aiškiai. Regionas visada reikalingas per awsRegion arba AWS_REGION aplinkos kintamąjį.

Official AWS docs

• Amazon Translate overview
• TranslateText API reference
• Setting formality
• Using brevity
• Custom terminology
• Parallel data
• Supported languages

OIDC (rekomenduojama)

permissions:
  id-token: write # for aws-actions/configure-aws-credentials OIDC
  contents: write
  pull-requests: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789012:role/gh-actions-translate
          aws-region: us-east-1

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            aws:
              region: us-east-1 # or rely on AWS_REGION from the step above
              formality: FORMAL
              brevity: true
          sourceLocale: en
          toLocales: '["es","fr","de"]'

Norėdami naudoti statinius klavišus, o ne OIDC, numeskite aws-actions/configure-aws-credentials žingsnį ir praeikite awsAccessKeyId / awsSecretAccessKey (per secrets) plius awsRegion.

"Google" debesies vertimas

Naudoja @google-cloud/translate (v2). Autentifikuokite naudodami API raktą (googleApiKey) arba paslaugos paskyros JSON kredencialą (googleCredentials). Pateikite tiksliai vieną; neprivalomas googleProjectId išvedamas iš kredencialų, kai jis praleistas.

Official Google docs

• Cloud Translation documentation
• Cloud Translation setup
• Translating text
• Supported languages

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            google:
              # Provide EITHER a service-account JSON credential...
              credentials: ${{ secrets.GCP_TRANSLATE_CREDENTIALS }}
              # ...OR an API key:
              # apiKey: ${{ secrets.GCP_TRANSLATE_API_KEY }}
              model: nmt
          sourceLocale: en
          toLocales: '["es","fr","de"]'

Tikslo specifikatoriaus susiejimas

Konkretaus teikėjo specifikatoriai susiejami ten, kur yra atitikmuo. Visa kita grįžta prie protingų nutylėjimo, todėl elgesys išlieka nuoseklus.

Lokalės kodai skiriasi priklausomai nuo teikėjo

Kiekvienas teikėjas naudoja savo lokalės kodus (pvz., supaprastinta kinų kalba zh-Hans "Azure", zh AWS ir zh-CN "Google"). Kodai perduodami tokie, kokie yra, ir valdo išvesties failų vardus, todėl pasirinkite reikšmes, toLocales palaiko jūsų pasirinktas teikėjas.