Quickstart

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)
An API key (how to create one)

1. Generate the project

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

The AI generates slides asynchronously. Poll the status endpoint:

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

Response (when done):

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

A freshly generated project is not published automatically. The publishedUrl field only appears once you publish the project.

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:

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.

Prerequisites

1. Generate the project

2. Poll for completion

Using a template

Next steps

API Reference

CLI Guide

​Prerequisites

​1. Generate the project

​2. Poll for completion

​3. View and share

​Using a template

​Next steps

API Reference

CLI Guide

Prerequisites

1. Generate the project

2. Poll for completion

3. View and share

Using a template

Next steps