# Configure translation service

After creating all the needed menus and adding language relations between them you need to configure the desired translation service that should be used for the ai based translations.

<figure><img src="/files/ZlicE4Ek2FMU25RN3xwK" alt=""><figcaption></figcaption></figure>

**Supported Services:**

* OpenAI
* OpenRouter

**Fields**:

* Service: Select the provider used for translation.
* Model
  * For OpenAI: Select a model from the list
  * For OpenRouter: Enter the model name manually
* API Key: Enter your API key to authenticate requests.

{% hint style="info" %}
**How to create and API-Key and why is it needed?**

An API key is a personal access token that allows your website to connect to translation services like OpenAI, OpenRouter, or DeepL. It is needed to authenticate your account, securely send content for translation, and track usage.

To create an API key, sign up with your chosen provider, log in to your account, and go to the API key section in the dashboard. There you can generate a new key and copy it into this tool.

Keep your API key secure and do not share it publicly. Make sure your account has active billing or credits, otherwise translations may not work.

**Learn more:**

* OpenAI: <https://platform.openai.com/api-keys>
* OpenRouter: <https://openrouter.ai/keys>
  {% endhint %}

{% hint style="danger" %}
**Important: Keep your API key secure**

* Do not expose it in frontend code or public repositories
* Ensure sufficient quota/credits are available for translation requests
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://joomtastic.gitbook.io/joomtastic-docs/getting-started/configure-translation-service.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.