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

# Quickstart

> Generate your first interactive, explorable deck with the Faces API in under 2 minutes.

Generate an interactive presentation from a text prompt in three API calls. Create a pitch deck, a portfolio, a guide, or a proposal.

## Prerequisites

* A Faces account ([sign up](https://faces.app/sign-up))
* An API key ([how to create one](/en/authentication))

## 1. Generate the project

```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. Poll for completion

The AI generates slides asynchronously. Poll the status endpoint:

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

Response (when done):

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

<Note>
  A freshly generated project is not published automatically. The `publishedUrl`
  field only appears once you [publish the project](/en/api-reference/publishing/publish).
</Note>

## 3. View and share

* **Editor**: Open `editorUrl` to refine your project. Edit content directly and tweak every detail.
* **Published**: Once you publish, share the `publishedUrl`. It's a live, interactive, explorable deck.

## Using a template

Want the same design but different content? Pass a `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..."
  }'
```

The AI preserves the layout, animations, and styling, updating only the content. Perfect for creating variations of a pitch, portfolio, guide, or proposal.

## Next steps

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/en/api-reference/overview">
    Full endpoint documentation with examples.
  </Card>

  <Card title="CLI Guide" icon="terminal" href="/en/cli/installation">
    Generate projects from the command line.
  </Card>
</CardGroup>