Skip to main content

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.

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

​
Prerequisites

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

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

​
3. View and share

  • Editor: Open editorUrl to refine your project. Edit content directly and tweak every detail.
  • Published: Share publishedUrl directly. 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.

​
Next steps

API Reference

Full endpoint documentation with examples.

CLI Guide

Generate projects from the command line.