deepl-go

DeepL Go Library

This is an unofficial client library and command line interface for the DeepL API.

Getting an authentication ley

To use the DeepL Go Library, you'll need an API authentication key. To get a key, please create an account here. With a DeepL API Free account you can translate up to 500,000 characters/month for free.

Installation

Library

Using the Go tools, from inside your project:

go get github.com/cluttrdev/deepl-go

Command Line Interface

Using the Go tools:

go install github.com/cluttrdev/deepl-go/cmd/deepl

Usage

Library

Import the package and construct a Translator.

import (
    "fmt"
    
    deepl "github.com/cluttrdev/deepl-go/pkg/api"
)

authKey := "f63c02c5-f056-..."  // Replace with your key
options := deepl.TranslatorOptions{}  // Using the default options

translator := deepl.NewTranslator(authKey, options)

translations, err := translator.TranslateText([]string{"Hello, world!"}, "FR")
if err == nil {
    fmt.Println(translations[0].Text)  // "Bonjour, le monde !"
}

Command Line Interface

$ export DEEPL_AUTH_KEY="f63c02c5-f056..."
$ deepl translate "Hello, world!" --target-lang FR
Bonjour, le monde !