> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser les sandbox avec Cloud dédié Forge

> Authentifiez les sandbox exécutés sur une capacité sans serveur à l’aide d’une clé API Cloud dédié Forge.

Si votre organisation utilise Cloud dédié Forge, authentifiez les sandbox exécutés sur une capacité sans serveur à l’aide d’une clé API issue de votre instance dédiée, et non de `wandb.ai`. Le client Python envoie votre clé et le nom d’hôte de votre instance au service CoreWeave Sandboxes, qui valide la clé auprès de votre instance. Transmettez le nom d’hôte de votre instance avec la clé afin que l’authentification s’effectue auprès de la bonne instance.

<h2 id="before-you-begin">
  Avant de commencer
</h2>

Vous avez besoin des éléments suivants :

* L’accès aux sandboxes activé pour votre instance de Cloud dédié Forge. Contactez votre équipe de compte Forge pour vérifier que votre instance dispose des mises à jour serveur requises et pour demander l’accès.
* L’URL de votre instance de Cloud dédié Forge, par exemple `https://[INSTANCE].wandb.io`. Le nom d’hôte doit se terminer par `.wandb.io`. Les instances utilisant un domaine personnalisé ne sont pas prises en charge.
* Python 3.11 ou version ultérieure.

Les déploiements autogérés de Forge, y compris les installations isolées du réseau, ne sont pas pris en charge. Le client TypeScript ne prend pas encore en charge les instances de Cloud dédié : utilisez donc le client Python.

<h2 id="get-an-api-key-from-your-instance">
  Obtenir une clé API depuis votre instance
</h2>

Créez une clé API personnelle sur votre instance dédiée, et non sur [forge.coreweave.com/settings#apikeys](https://forge.coreweave.com/settings#apikeys) :

1. Connectez-vous à votre instance de Cloud dédié Forge.
2. Cliquez sur l’icône du profil utilisateur, puis sur **Paramètres utilisateur**.
3. Faites défiler jusqu’à la section **Clés API** et créez une clé.

Forge n’affiche la clé complète qu’une seule fois, au moment de sa création. Pour plus d’informations, voir [Comment puis-je trouver ma clé API ?](/fr/support/models/articles/how-do-i-find-my-api-key#personal-api-key) dans la documentation Forge.

La clé doit être une clé API personnelle (utilisateur). Tout autre type d’identifiant d’authentification Forge est refusé.

<h2 id="point-the-client-at-your-instance">
  Configurer l’authentification de l’instance
</h2>

Installez le client Python :

```bash theme={"system"}
uv pip install 'cwsandbox>=1.14.2'
```

Définissez le nom d'hôte de votre instance et votre clé API. Remplacez `[INSTANCE]` par le préfixe du nom d'hôte de votre instance et `[FORGE-API-KEY]` par la clé que vous avez créée :

```bash theme={"system"}
export FORGE_HOST="[INSTANCE].wandb.io"
export FORGE_API_KEY="[FORGE-API-KEY]"
```

L’exemple transmet le nom d’hôte dans l’en-tête `x-wandb-host`. Indiquez le nom d’hôte sans `https://` ni chemin. Le Sandbox API endpoint ne change pas.

<h2 id="run-a-sandbox">
  Exécuter une sandbox
</h2>

Transmettez la clé et le nom d’hôte de l’instance dédiée via `AuthHeaders` :

```python theme={"system"}
import os
from cwsandbox import AuthHeaders, Sandbox

forge_auth = AuthHeaders(
    headers={
        "x-wandb-api-key": os.environ["FORGE_API_KEY"],
        "x-wandb-host": os.environ["FORGE_HOST"],
    },
    strategy="wandb_api_key",
)

with Sandbox.run(
    auth=forge_auth,
    resources={"cpu": "1", "memory": "1Gi"},
) as sandbox:
    result = sandbox.exec(["echo", "Hello!"]).result()
    print(result.stdout)
```

Si la commande réussit, `Hello!` s'affiche dans la sortie.

En cas d'échec de l'authentification, vérifiez que `FORGE_HOST` correspond à l'instance sur laquelle vous avez créé la clé. Une clé issue d'une instance dédiée ne permet pas de s'authentifier auprès de `wandb.ai`, et inversement, une clé `wandb.ai` ne permet pas de s'authentifier auprès d'une instance dédiée.

<h2 id="next-steps">
  Étapes suivantes
</h2>

* [Premiers pas avec CoreWeave Sandboxes](/fr/products/sandboxes/get-started) présente les modes de placement, les identifiants d’authentification et le débordement (spillover).
* La documentation du [client Python](/fr/products/sandboxes/client) traite du cycle de vie, de l’exécution, des opérations sur les fichiers et d’autres modèles d’utilisation du SDK.