Inicio rápido

Genera una presentación interactiva a partir de un prompt de texto con tres llamadas a la API. Crea un pitch deck, un portafolio, una guía o una propuesta.

Requisitos previos

Una cuenta de Faces (crear cuenta)
Una API key (cómo crear una)

1. Generar el proyecto

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"
  }'

Response:

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

2. Consultar el estado hasta que termine

La IA genera las diapositivas de forma asíncrona. Consulta el endpoint de estado:

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

Response (cuando termina):

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

Un proyecto recién generado no se publica automáticamente. El campo publishedUrl solo aparece una vez que publicas el proyecto.

3. Ver y compartir

Editor: Abre editorUrl para refinar tu proyecto. Edita el contenido directamente y ajusta cada detalle.
Publicado: Una vez que publiques, comparte el publishedUrl. Es una presentación en vivo, interactiva y explorable.

Usar una plantilla

¿Quieres el mismo diseño pero con contenido distinto? Pasa 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..."
  }'

La IA conserva el diseño, las animaciones y los estilos, y actualiza únicamente el contenido. Ideal para crear variaciones de un pitch, portafolio, guía o propuesta.

Requisitos previos

1. Generar el proyecto

2. Consultar el estado hasta que termine

3. Ver y compartir

Usar una plantilla

Próximos pasos

Referencia de la API

Guía de la CLI

​Requisitos previos

​1. Generar el proyecto

​2. Consultar el estado hasta que termine

​3. Ver y compartir

​Usar una plantilla

​Próximos pasos

Referencia de la API

Guía de la CLI

Requisitos previos

1. Generar el proyecto

2. Consultar el estado hasta que termine

3. Ver y compartir

Usar una plantilla

Próximos pasos