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

# Démarrage rapide : choisissez comment vous allez utiliser Flatkey

> Quatre façons d'utiliser Flatkey — l'API REST, le SDK OpenAI, la CLI Flatkey ou votre agent de code. Une clé et un catalogue de modèles derrière chacune d'elles.

Flatkey vous donne une clé et quatre façons de l'utiliser. Ces quatre options partagent le même compte, le même solde et le même catalogue de modèles — la seule question est donc de savoir laquelle correspond le mieux à votre façon de travailler.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/console-choose-how.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=99ada27fab6ab988299090f74cd627c0" alt="Les quatre façons d'utiliser Flatkey, présentées dans la Console Flatkey" width="3000" height="852" data-path="images/quickstart/console-choose-how.png" />
</Frame>

<Tip>
  Vous n'avez pas à faire un choix définitif. Commencez par l'option la plus proche de ce que vous faites aujourd'hui, puis ajoutez les autres plus tard avec la même clé.
</Tip>

## Avant de commencer

Créez une clé sur [console.flatkey.ai/keys](https://console.flatkey.ai/keys). Les clés Flatkey commencent par `sk-`. Chaque option ci-dessous utilise cette même clé, alors conservez-la dans une variable d'environnement et hors du contrôle de version.

Chaque panneau de la Console vous permet également de choisir une clé existante plutôt que d'en créer une nouvelle, et l'insère directement dans l'extrait de code affiché.

## API pour les développeurs

Appelez n'importe quel modèle via une simple requête HTTP compatible avec OpenAI. Pas de SDK, pas de dépendances — si vous avez un client HTTP, vous êtes prêt.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-api.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=3dd0485d2730b29d52b3285bdbe176b7" alt="Le panneau API pour les développeurs, avec une requête prête à l'emploi" width="1540" height="1150" data-path="images/quickstart/modal-api.png" />
</Frame>

La Console construit la requête pour vous : choisissez une clé, choisissez un modèle, et copiez l'extrait en **cURL**, **Node.js** ou **Python**.

```bash theme={"dark"}
curl https://router.flatkey.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Say hello in one sentence."}]}'
```

<Card title="Accès API" icon="code" href="/fr/guides/api-access">
  URL de base, authentification, points de terminaison disponibles et gestion des erreurs.
</Card>

## SDKs pour les développeurs

Conservez le SDK OpenAI que vous utilisez déjà et pointez-le vers Flatkey. Votre code de requête ne change pas — seule l'URL de base change.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-sdk.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=255f7df4814995aa07fb1816ad7342d1" alt="Le panneau SDKs pour les développeurs, avec la configuration du SDK" width="1540" height="1150" data-path="images/quickstart/modal-sdk.png" />
</Frame>

Même principe que ci-dessus : choisissez une clé et un modèle, puis copiez la configuration correspondant à votre langage.

```python theme={"dark"}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)
```

<CardGroup cols={2}>
  <Card title="SDK OpenAI" icon="code" href="/fr/guides/openai-sdk">
    Configuration Python et Node.js, streaming et appel d'outils.
  </Card>

  <Card title="SDK Anthropic" icon="code" href="/fr/guides/anthropic-sdk">
    Acheminez les requêtes Claude via Flatkey de la même manière.
  </Card>
</CardGroup>

## CLI Flatkey

Générez des images et des vidéos depuis votre terminal, ou laissez un assistant IA piloter la CLI pour vous.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-cli.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=a31f30bab8e5eecfc1f84fe593749af1" alt="Le panneau CLI Flatkey, montrant l'installation, la connexion et la première invite" width="1540" height="930" data-path="images/quickstart/modal-cli.png" />
</Frame>

<Steps>
  <Step title="Installer">
    ```bash theme={"dark"}
    npm i -g @flatkey-ai/cli
    ```
  </Step>

  <Step title="Se connecter">
    ```bash theme={"dark"}
    flatkey login
    ```
  </Step>

  <Step title="Commencer à créer">
    Demandez à votre assistant IA ce que vous voulez, et laissez-le exécuter la CLI :

    ```text theme={"dark"}
    Use Flatkey CLI to generate a "beautiful sunrise" picture.
    ```
  </Step>
</Steps>

<Card title="Flatkey CLI avec un agent IA" icon="terminal" href="/fr/guides/flatkey-cli">
  Commandes, sortie JSON pour les agents et récupération après erreur.
</Card>

## Codex & Claude Code

Connectez votre agent de code une seule fois, puis utilisez Flatkey depuis les projets que vous avez déjà ouverts.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-agents.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=0fadd534691bdc978983917445268b6f" alt="Le panneau Codex et Claude Code, avec la commande d'installation" width="1540" height="1064" data-path="images/quickstart/modal-agents.png" />
</Frame>

La Console vous fournit une seule commande d'installation pour **macOS**, **Linux** ou **Windows**. Elle installe l'agent si vous ne l'avez pas déjà, vous demande votre clé, et écrit la configuration à votre place.

<Warning>
  L'installateur est interactif. Il vous demande si vous voulez Claude Code ou Codex CLI, et nécessite que Node.js soit déjà installé.
</Warning>

<CardGroup cols={3}>
  <Card title="Claude Code" icon="terminal" href="/fr/guides/claude-code">
    Configuration manuelle ou CC Switch.
  </Card>

  <Card title="Codex CLI" icon="code" href="/fr/guides/codex-cli">
    Acheminez Codex CLI via Flatkey.
  </Card>

  <Card title="Codex Desktop" icon="desktop" href="/fr/guides/codex-desktop">
    Configurez l'application de bureau.
  </Card>
</CardGroup>

## Vérifiez que tout fonctionne

Quelle que soit l'option choisie, ouvrez **Usage Logs** dans la [Console](https://console.flatkey.ai) après votre première requête. Vous devriez la voir apparaître avec le modèle, le nombre de tokens, la latence et le coût.

<img src="https://mintcdn.com/flatkey/ln614ti05NsEoN0h/images/quickstart/flatkey-usage-logs.png?fit=max&auto=format&n=ln614ti05NsEoN0h&q=85&s=90a23fb955d4a547c179087b73ab59df" alt="Utilisez le filtre Model Name dans les journaux d'utilisation Flatkey" width="1600" height="840" data-path="images/quickstart/flatkey-usage-logs.png" />

Si rien n'apparaît, attendez quelques secondes et effectuez une nouvelle recherche, puis vérifiez la clé API et l'URL de base réellement utilisées par la requête.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Répertoire des modèles" icon="list" href="https://flatkey.ai/models">
    Tous les modèles pris en charge, avec tarification et disponibilité en temps réel.
  </Card>

  <Card title="Erreurs API" icon="triangle-exclamation" href="/fr/api-reference/errors">
    Codes de statut, formats de réponse et conduite à tenir.
  </Card>

  <Card title="Génération de texte" icon="message" href="/fr/guides/text-generation">
    Streaming, appel d'outils et sortie structurée.
  </Card>

  <Card title="Génération de vidéo" icon="video" href="/fr/guides/video-generation">
    Soumettez une tâche, interrogez son statut et téléchargez le MP4.
  </Card>
</CardGroup>
