> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-dbrian-docs-serverless-training-quickstart.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# wandb login
export const GitHubLink = ({url}) =>
Source GitHub
;
## Utilisation
```bash theme={null}
login [OPTIONS] [KEY]...
```
## Description
Authentifiez votre machine auprès de W\&B.
Enregistrez localement une clé API pour vous authentifier auprès des services W\&B.
Par défaut, les identifiants sont stockés sans vérification côté serveur.
Si aucune clé API n’est fournie en argument, la commande recherche les
identifiants dans l’ordre suivant :
1. La variable d’environnement WANDB\_API\_KEY
2. Le paramètre api\_key dans un fichier de paramètres système ou d’espace de travail (utilisez
`wandb status` pour voir quel fichier de paramètres est utilisé)
3. Le fichier .netrc (\~/.netrc, \~/\_netrc ou le chemin indiqué par la variable d’environnement NETRC)
4. Une invite interactive (si un TTY est disponible)
Pour les déploiements auto-hébergés ou sur Cloud dédié, spécifiez l’URL du serveur
avec `--host`, ou définissez la variable d’environnement WANDB\_BASE\_URL.
Par exemple, pour vous connecter de manière interactive (une invite vous demande la clé API) :
```bash theme={null}
wandb login
```
Pour vous connecter à l’aide d’une clé API explicite (WANDB\_API\_KEY\_EXAMPLE) :
```bash theme={null}
wandb login WANDB_API_KEY_EXAMPLE
```
Pour vous connecter et vérifier que la clé API est valide :
```bash theme={null}
wandb login --verify
```
Pour vous connecter au cloud public de W\&B plutôt qu’à une instance auto-hébergée configurée :
```bash theme={null}
wandb login --cloud
```
Pour vous connecter à une instance W\&B auto-hébergée :
```bash theme={null}
wandb login --host https://my-wandb-server.example.com
```
Pour forcer une nouvelle demande de connexion, même si vous êtes déjà authentifié :
```bash theme={null}
wandb login --relogin
```
## Formats de clé API
W\&B génère des clés API au format `wandb_v1_` (environ 92 caractères). Les anciennes versions du SDK attendent exactement 40 caractères et rejettent le nouveau format avec `API key must be 40 characters long`. Mettez à niveau le SDK (`pip install -U wandb`) et exécutez `wandb login --relogin`.
Les clés générées sur [wandb.ai/authorize](https://wandb.ai/authorize) ne s’affichent qu’une seule fois, au moment de leur création. Copiez-les immédiatement : vous ne pourrez plus les récupérer après avoir fermé la boîte de dialogue.
Pour les versions du SDK verrouillées, les clés héritées et les erreurs associées, voir [Pourquoi ma clé API échoue-t-elle avec « must be 40 characters long » ?](/fr/support/models/articles/why-does-my-api-key-fail-with-must-be-40-characters).
## Arguments
| Nom | Par défaut | Type |
| ----- | ---------- | ----- |
| `key` | STR | False |
## Options
| Flag | Type | Description |
| -------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cloud` | BOOL Flag | Se connecter au cloud public de W\&B ([https://api.wandb.ai](https://api.wandb.ai)). Ne peut pas être utilisé avec --host. **Par défaut** : False |
| `--host, --base-url` | STR | Se connecter à une instance spécifique du serveur W\&B via son URL (par ex. [https://my-wandb.example.com](https://my-wandb.example.com)). Ne peut pas être utilisé avec --cloud. **Par défaut** : None |
| `--relogin` | BOOL Flag | Forcer une nouvelle demande de connexion en ignorant les identifiants existants. **Par défaut** : None |
| `--verify` | BOOL Flag | Vérifier la clé API auprès de W\&B après l’avoir enregistrée. Si la vérification réussit, afficher l’origine des identifiants et l’équipe par défaut. **Par défaut** : False |