> ## 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.

# Inicio rápido

> Genera tu primera presentación interactiva y explorable con la API de Faces en menos de 2 minutos.

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](https://faces.app/sign-up))
* Una API key ([cómo crear una](/es/authentication))

## 1. Generar el proyecto

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

Response:

```json theme={null}
{
  "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:

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

Response (cuando termina):

```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 proyecto recién generado no se publica automáticamente. El campo `publishedUrl`
  solo aparece una vez que [publicas el proyecto](/es/api-reference/publishing/publish).
</Note>

## 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`:

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

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

<CardGroup cols={2}>
  <Card title="Referencia de la API" icon="code" href="/es/api-reference/overview">
    Documentación completa de los endpoints con ejemplos.
  </Card>

  <Card title="Guía de la CLI" icon="terminal" href="/es/cli/installation">
    Genera proyectos desde la línea de comandos.
  </Card>
</CardGroup>