Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.faces.app/llms.txt

Use this file to discover all available pages before exploring further.

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

​
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..."
}

​
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...",
  "publishedUrl": "https://your-subdomain.faces.site/threadcycle",
  "createdAt": "2025-01-15T10:30:00.000Z"
}

​
3. Ver y compartir

  • Editor: Abre editorUrl para refinar tu proyecto. Edita el contenido directamente y ajusta cada detalle.
  • Publicado: Comparte publishedUrl directamente. 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.

​
Próximos pasos

Referencia de la API

Documentación completa de los endpoints con ejemplos.

Guía de la CLI

Genera proyectos desde la línea de comandos.