Démarrage rapide

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)
Une clé API (comment en créer une)

1. Générer le projet

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 :

{
  "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 :

curl https://faces.app/api/v1/projects/jobs/cm1abc123... \
  -H "Authorization: Bearer $FACES_API_KEY"

Réponse (une fois terminé) :

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

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.

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 :

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.

Prérequis

1. Générer le projet

2. Interroger l’état d’avancement

3. Consulter et partager

Utiliser un template

Étapes suivantes

Référence de l'API

Guide CLI

​Prérequis

​1. Générer le projet

​2. Interroger l’état d’avancement

​3. Consulter et partager

​Utiliser un template

​Étapes suivantes

Référence de l'API

Guide CLI

Prérequis

1. Générer le projet

2. Interroger l’état d’avancement

3. Consulter et partager

Utiliser un template

Étapes suivantes