Skip to main content

​
Quickstart

Generate a project from a text prompt in three API calls.

​
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 the result

  • Editor: Open editorUrl to refine slides, change styles, or edit content
  • Published: Share publishedUrl directly. It’s a live, interactive presentation.

​
Using a template

Want the same design but different content? Pass a templateProjectId: 
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",
    "templateProjectId": "cm1xyz789..."
  }'
The AI preserves the layout, animations, and styling, updating only the content.

​
Next steps

API Reference

Full endpoint documentation with examples.

CLI Guide

Generate projects from the command line.