Skip to main content
POST
/
projects
/
generate
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 about AI in healthcare"
  }'

{
  "jobId": "cm1abc123def456",
  "status": "processing",
  "editorUrl": "https://faces.app/s/xK9mP2qR"
}
​
prompt
string
required
A detailed description of the project to generate. Include the topic, number of slides, and any style preferences.
​
templateProjectId
string
Use an existing project as a design template. The layout and styling are preserved. Only the content is regenerated.
​
inspirationId
string
ID of a style inspiration to apply.
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 about AI in healthcare"
  }'

{
  "jobId": "cm1abc123def456",
  "status": "processing",
  "editorUrl": "https://faces.app/s/xK9mP2qR"
}
​
jobId
string
Unique job identifier. Use with Get job status to poll for completion.
​
status
string
Always processing on creation.
​
editorUrl
string
URL to open the project in the Faces editor. Available immediately, even while generating.