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

# Démarrage rapide

> Générez votre premier deck interactif et explorable avec l'API Faces en moins de 2 minutes.

Générez une présentation interactive à partir d'un prompt texte en trois appels d'API. Créez un pitch deck, un portfolio, un guide ou une proposition.

## Prérequis

* Un compte Faces ([créer un compte](https://faces.app/sign-up))
* Une clé API ([comment en créer une](/fr/authentication))

## 1. Générer le projet

```bash theme={null}
curl -X POST https://faces.app/api/v1/projects/generate \
  -H "Authorization: Bearer $FACES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "5-slide pitch deck for a sustainable fashion startup called ThreadCycle"
  }'
```

Réponse :

```json theme={null}
{
  "jobId": "cm1abc123...",
  "status": "processing",
  "editorUrl": "https://faces.app/s/xK9mP2...",
  "estimatedDuration": "240 seconds"
}
```

## 2. Interroger l'état d'avancement

L'IA génère les diapositives de manière asynchrone. Interrogez l'endpoint de statut :

```bash theme={null}
curl https://faces.app/api/v1/projects/jobs/cm1abc123... \
  -H "Authorization: Bearer $FACES_API_KEY"
```

Réponse (une fois terminé) :

```json theme={null}
{
  "jobId": "cm1abc123...",
  "status": "completed",
  "editorUrl": "https://faces.app/s/xK9mP2...",
  "finalDuration": "45 seconds",
  "createdAt": "2025-01-15T10:30:00.000Z"
}
```

<Note>
  Un projet fraîchement généré n'est pas publié automatiquement. Le champ `publishedUrl`
  n'apparaît qu'une fois que vous avez [publié le projet](/fr/api-reference/publishing/publish).
</Note>

## 3. Consulter et partager

* **Éditeur** : ouvrez `editorUrl` pour peaufiner votre projet. Modifiez le contenu directement et ajustez chaque détail.
* **Publié** : une fois le projet publié, partagez le `publishedUrl`. C'est un deck en direct, interactif et explorable.

## Utiliser un template

Vous souhaitez le même design mais un contenu différent ? Passez un `templateId` :

```bash theme={null}
curl -X POST https://faces.app/api/v1/projects/generate \
  -H "Authorization: Bearer $FACES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Same deck but for a pet food delivery startup called BarkBox",
    "templateId": "cm1xyz789..."
  }'
```

L'IA conserve la mise en page, les animations et le style, et ne met à jour que le contenu. Idéal pour créer des variantes d'un pitch, d'un portfolio, d'un guide ou d'une proposition.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Référence de l'API" icon="code" href="/fr/api-reference/overview">
    Documentation complète des endpoints avec exemples.
  </Card>

  <Card title="Guide CLI" icon="terminal" href="/fr/cli/installation">
    Générez des projets depuis la ligne de commande.
  </Card>
</CardGroup>