Premiers pas
Avant d'installer quel que soit le paquet, il vous faut trois choses : un compte, un projet avec son IA configurée et un jeton API du projet.
1. Créez votre compte
Inscrivez-vous gratuitement sur translateprojects.dev/accounts/register. Aucune carte de crédit n'est demandée.
2. Créez un projet
Dans le panneau, allez dans Projets et créez-en un nouveau. Utilisez un projet par application ou site que vous souhaitez traduire.
| Champ | À quoi ça sert |
|---|---|
| Nom du projet | Un nom pour le reconnaître dans le panneau. |
| Description du projet | Contexte pour l'IA : le sujet, qui le lit et le ton. Une bonne description améliore les traductions. |
| Catégorie | C'est aussi du contexte pour l'IA (par exemple, documentation technique ou jeux vidéo). Si ce n'est pas dans la liste, saisissez-en un nouveau. |
| Langue par défaut | La langue dans laquelle vous écrivez vos textes. Elle doit correspondre à la langue de base que vous configurez dans le paquet. |
| Fournisseur d'IA | Claude, OpenAI, DeepSeek ou Gemini. |
| Modèle d'IA pour traduire | Le modèle de ce fournisseur qui effectuera les traductions. |
| Clé API de votre fournisseur d'IA | La clé de votre compte auprès de ce fournisseur. Elle est stockée chiffrée et n'est utilisée que pour les textes qui ne sont pas dans le réseau partagé. |
Les langues cibles s'ajoutent automatiquement la première fois que le paquet les demande. Si vous en désactivez une dans le panneau, l'API rejette cette langue jusqu'à ce que vous la réactiviez.
3. Générez le jeton API
Dans le projet, ouvrez Jetons API et cliquez sur Créer un nouveau jeton. Ce jeton identifie le projet auprès de l'API ; ce n'est pas la clé de votre fournisseur d'IA.
Enregistrez-le dans la variable d'environnement TRANSLATE_PROJECTS_API_KEY:
export TRANSLATE_PROJECTS_API_KEY=tu_token
Ou dans le fichier .env de votre projet. Laravel le lit automatiquement ; les commandes Node (React, Next.js, Astro, Docusaurus) et Django, non, donc exportez la variable ou chargez-la vous-même (sous Node 20 ou supérieur, avec node --env-file=.env).
TRANSLATE_PROJECTS_API_KEY=tu_token
N'écrivez jamais le jeton dans le code et ne le poussez pas dans le dépôt. Lisez-le toujours depuis la variable d'environnement ; en CI, stockez-le comme secret. S'il fuite, désactivez-le dans Jetons API et créez-en un autre.