> For the complete documentation index, see [llms.txt](https://wiki.retrobat.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.retrobat.org/francais/utilisation-avancee/ai-translation-service.md).

# IA de Traduction

Le service de traduction par IA traduit le texte d'un jeu en direct. Quand vous appuyez sur le raccourci, RetroArch prend une capture du jeu, l'envoie à un service en ligne qui lit et traduit le texte, puis affiche la traduction par-dessus le jeu.

{% hint style="info" %}

* Le service ne fonctionne qu'avec les **cores RetroArch**.
* Une **connexion Internet** est nécessaire.
* La traduction est automatique : elle peut être approximative, et certains textes (polices stylisées, petits textes) peuvent être mal lus.
  {% endhint %}

## Activer la traduction

1. Ouvrez le [**MENU PRINCIPAL**](https://wiki.retrobat.org/francais/navigation/main-menu.md) > **PARAMÈTRES DES JEUX**, groupe **OPTIONS RETROARCH** > **TRADUCTION ASSISTÉE PAR IA**.
2. Activez **ACTIVER LE SERVICE DE TRADUCTION PAR IA**.
3. Choisissez votre **LANGUE CIBLE** : la langue dans laquelle le texte est traduit. La langue du jeu est détectée automatiquement.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FjsswFLoUhucnYXbnAFMT%2Fimage.png?alt=media&amp;token=53f98f41-8c82-4bf7-bd0c-862a1a254474" alt=""><figcaption></figcaption></figure></div>

<table><thead><tr><th width="289">Option</th><th>Effet</th></tr></thead><tbody><tr><td><strong>ACTIVER LE SERVICE DE TRADUCTION PAR IA</strong></td><td>Active la traduction dans les jeux RetroArch.</td></tr><tr><td><strong>LANGUE CIBLE</strong></td><td>Langue de la traduction.</td></tr><tr><td><strong>URL DU SERVICE DE TRADUCTION IA</strong></td><td>Adresse du service de traduction. Laissez-la vide pour utiliser le service par défaut (voir plus bas).</td></tr><tr><td><strong>PAUSE SUR L'ÉCRAN TRADUIT</strong></td><td>Met le jeu en pause pendant l'affichage de la traduction.</td></tr></tbody></table>

## Traduire en jeu

| Action                                                        | Manette               |
| ------------------------------------------------------------- | --------------------- |
| Traduire l'écran                                              | HOTKEY + R1           |
| Masquer la traduction (et reprendre le jeu s'il est en pause) | HOTKEY + R1 à nouveau |

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FK3yPwnRhf6UlBFSydSk0%2Fimage.png?alt=media&amp;token=454bdfd8-8b6c-4294-8cd5-3f27b25a67c3" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Si vous avez personnalisé vos raccourcis, utilisez votre propre combinaison. Voir la page Raccourcis.
{% endhint %}

## Service de traduction

Par défaut, RetroBat utilise le service **ZTranslate** avec une clé partagée : il fonctionne sans aucun compte. Cette clé étant partagée par de nombreux joueurs, le service peut parfois être lent ou indisponible.

Pour utiliser votre propre clé :

1. Créez un compte gratuit sur [ztranslate.net](https://ztranslate.net), puis récupérez votre clé API dans votre profil.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FIFz7wHv2nVrbx9gROlfe%2Fimage.png?alt=media&amp;token=bc6f05e9-7e94-4e32-a637-b0c7d46edd15" alt=""><figcaption></figcaption></figure></div>

2. Dans **URL DU SERVICE DE TRADUCTION IA**, saisissez : `http://ztranslate.net/service?api_key=VOTRE_CLÉ` (remplacez `VOTRE_CLÉ` par votre clé).

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F7iS2TwkkPbCYDRaeRdM7%2Fimage.png?alt=media&amp;token=2a22c717-e38c-437b-a43f-82ecb7174d09" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Écrivez l'adresse avec `http://`, et non `https://`. RetroBat ajoute lui-même à la fin de l'adresse les réglages de langue et d'affichage : ne les ajoutez pas.
{% endhint %}

## Problèmes fréquents

| Problème                                      | Solution                                                                                                       |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Rien ne se passe en appuyant sur HOTKEY + R1  | Vérifiez que le service est activé et que le jeu utilise un core RetroArch. Vérifiez votre connexion Internet. |
| La traduction est longue ou n'apparaît jamais | Le service partagé est peut-être surchargé : réessayez plus tard, ou utilisez votre propre clé.                |
| La traduction est fausse ou incomplète        | Le texte n'a pas pu être bien lu (police stylisée, petit texte). Essayez sur un écran au texte plus lisible.   |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.retrobat.org/francais/utilisation-avancee/ai-translation-service.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
