# gt: General Translation CLI tool: gt api-key create URL: https://generaltranslation.com/fr/docs/cli/reference/commands/api-key-create.mdx Docs index: https://generaltranslation.com/llms.txt Description: Créez une clé API de projet dotée de permissions explicites et affichez son secret une seule fois. Référence API de la commande gt api-key create. Créez des identifiants pour le runtime ou l'automatisation sans modifier l'environnement local ni les fichiers de configuration. Authentifiez-vous avec une session enregistrée ou une clé explicite autorisée, comme décrit dans [Configurer la CLI](/docs/cli/guides/configuring#credentials). ## Vue d'ensemble [#overview] ```bash npx gt api-key create --name --permission [options] ``` | Paramètre | Description | Type | Facultatif | Valeur par défaut | | ---------------------------------------------- | ------------------------------------------- | ---------- | ---------- | ------------------------------------------- | | [`--name `](#name) | Nom de la clé (non vide). | `string` | Non | — | | [`--permission `](#permission) | Autorisations canoniques explicites. | `string[]` | Non | — | | [`-c, --config `](#config) | Chemin d’accès au fichier de configuration. | `string` | Oui | Résolu automatiquement | | [`--api-key `](#api-key) | Remplace explicitement l’authentification. | `string` | Oui | `GT_API_KEY`, sinon la session de connexion | | [`--project-id `](#project-id) | Projet cible. | `string` | Oui | Configuration ou environnement | ## Fonctionnement [#how-it-works] L'appelant doit disposer de l'autorisation `project:api_keys:write` ainsi que de la permission de déléguer chacune des autorisations demandées. Si une autorisation demandée n'est pas disponible, l'ensemble de l'opération échoue (tout ou rien) ; la CLI ne réduit pas la sélection en silence. Les clés de projet ne peuvent pas détenir `project:api_keys:write` ni créer d'autres clés. En cas de succès, seul le nouveau secret, suivi d'un saut de ligne, est écrit sur stdout. Les diagnostics sont envoyés sur stderr. Le secret contourne le logger et le fichier journal, y compris avec `--quiet` ou `GT_LOG_FORMAT=json` ; il ne fait pas partie des métadonnées JSON. La commande n'écrit aucun fichier d'environnement ou de configuration. ## Options [#flags] Les [options globales](/docs/cli/reference/global-options) s'appliquent également. ### Nom **Type** `string` · **Obligatoire** · **Valeur par défaut** — Le nom d’affichage de la clé. Les espaces en début et en fin de chaîne sont supprimés ; un résultat vide est rejeté avant l’envoi de toute requête. ### Permission **Type** `string[]` · **Obligatoire** · **Valeur par défaut** — Indiquez un ou plusieurs noms de permission canoniques, séparés par des espaces ou en répétant l'option : * `project:write` * `project:context:read` * `project:context:write` * `project:files:read` * `project:files:write` * `project:translations:generate` * `project:translations:enqueue` Les caractères génériques, les noms de préréglages et les options de type de clé ne sont pas pris en charge. Omettre les permissions provoque une erreur et n'accorde pas un accès complet. Indiquez explicitement chaque autorisation requise : une autorisation d'écriture n'inclut pas automatiquement l'accès en lecture. ### Config **Type** `string` · **Facultatif** · **Valeur par défaut** Résolue automatiquement Lit les paramètres du projet depuis ce fichier de configuration JSON ; l’extension `.json` peut être omise. Sans cette option, la détection habituelle de `gt.config.json` s’applique. ### Clé API **Type** `string` · **Facultatif** · **Valeur par défaut** `GT_API_KEY`, sinon la session de connexion enregistrée Remplace l'authentification par une clé autorisée fournie explicitement. En cas de clé invalide ou aux droits insuffisants, aucun repli sur la session de connexion n'a lieu. Privilégiez les secrets définis dans des variables d'environnement plutôt que des secrets saisis en clair, qui resteraient dans l'historique du shell. (Voir [priorité des identifiants](/docs/cli/guides/configuring#credentials).) ### ID du projet **Type** `string` · **Facultatif** · **Valeur par défaut** Configuration ou environnement Sélectionne le projet cible. Si l'ID défini dans la configuration diffère de celui fourni par l'option ou de l'ID résolu depuis l'environnement, la validation échoue. En l'absence d'ID dans la configuration, l'option prévaut sur l'environnement. Les variables de projet préfixées propres aux frameworks pris en charge sont également prises en compte lors de la résolution. ## Exemple [#example] Après vous être connecté avec [`gt login`](/docs/cli/reference/commands/login), créez une clé runtime de développement limitée à la génération : ```bash npx gt api-key create \ --project-id your-project-id \ --name "Runtime translations" \ --permission project:translations:generate ``` Conservez le secret renvoyé en lieu sûr. Cette clé limitée à la génération ne permet pas d'exécuter l'intégralité du pipeline [`gt translate`](/docs/cli/reference/commands/translate). Pour la CI, accordez les autorisations couvrant l'[ensemble du workflow](/docs/cli/guides/configuring#credentials) et enregistrez la clé dans le gestionnaire de secrets de votre fournisseur de CI, et non dans des fichiers commités. Considérez stdout comme une donnée secrète. Ne redirigez pas stderr vers stdout, n'envoyez pas stdout dans des journaux partagés et n'exposez aucune clé, pas même une clé limitée à la génération, dans des bundles déployés sur navigateur ou mobile. Relancer la commande peut créer une nouvelle clé ; il n'existe ni annulation à distance ni garantie de nouvelle tentative idempotente. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.