Clés et environnements

Un projet Langsys émet deux types de clés API. Celle que vous utilisez dépend de ce que vous faites : découvrir de nouvelles phrases (développement) ou simplement afficher des traductions finalisées (production). Les deux sont générées dans le tableau de bord — le guide de démarrage rapide vous explique comment faire.

Regarder · 1:30 Clés et environnements

Deux clés, deux rôles

Type de clé	Possible	À utiliser dans
Écriture	Récupérez les traductions et enregistrez dans le projet les phrases nouvellement détectées.	Développement / côté serveur. Ne l'incluez pas dans les bundles publics.
Lecture seule	Récupère uniquement les traductions. Ne peut rien enregistrer ni modifier.	Production / navigateur. Peut être intégrée sans risque dans le code client.

Pourquoi une clé en lecture seule est sûre dans le navigateur. Elle ne peut tout simplement pas écrire : le pire que l'on puisse en faire, c'est lire les mêmes traductions publiques que vos utilisateurs voient déjà. C'est tout l'intérêt de cette séparation.

Le flux type

Regarder · 1:30 Clés d'API en production

Développez avec une clé d'écriture. Au fil de la création de l'interface, les nouvelles phrases sont détectées, enregistrées et traduites automatiquement dans vos locales cibles.
Une fois le texte stabilisé, passez l’application déployée à une clé en lecture seule.
Les utilisateurs récupèrent le catalogue finalisé ; rien de ce qu'ils détiennent ne peut modifier votre projet.

Développement

# .env.local — development
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key   # discovers + registers new phrases

Production

# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key   # only fetches — safe to ship

Ce que contient un projet

Regarder · 2:24 Paramètres du traducteur IA

La clé s'authentifie auprès d'un projet, qui définit l'univers de traduction de votre application :

une langue de base — la langue dans laquelle sont rédigées vos phrases sources ;
un ensemble de locales cibles — toutes les langues dans lesquelles les phrases sont traduites automatiquement ;
paramètres de traduction automatique — le niveau de fournisseur et la traduction automatique ou non des nouvelles phrases.

Vous exécutez ces démos en local ? Faites pointer le SDK vers votre propre instance avec une clé en lecture seule — voir le fichier .env.example du projet. Sinon, les panneaux s'exécutent en mode démo (texte source uniquement).