Skip to main content
POST
/
projects
/
generate
Generate a project
curl --request POST \
  --url https://faces.app/api/v1/projects/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "5-slide pitch deck about AI in healthcare with a modern dark theme",
  "templateId": "<string>",
  "inspirationId": "<string>"
}
'
{
  "jobId": "<string>",
  "editorUrl": "<string>",
  "estimatedDuration": "240 seconds",
  "templateId": "<string>"
}

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.

Authorizations

​
Authorization
string
header
required

API key with "faces_" prefix. Create one at Settings > Developers.

Body

application/json
​
prompt
string
required

A detailed description of the project to generate.

Minimum string length: 1
Example:

"5-slide pitch deck about AI in healthcare with a modern dark theme"

​
templateId
string

Use an existing project as a template. Layout and design are preserved, content and controls change.

​
inspirationId
string

ID of a style inspiration to apply.

Response

Job created

​
jobId
string
required

Poll this ID with the status endpoint.

​
status
enum<string>
required
Available options:
processing
​
editorUrl
string<uri>
required

URL to open the project in the Faces editor.

​
estimatedDuration
string
required

Estimated generation time. 30s with a template, 60s with inspiration, 240s from scratch.

Example:

"240 seconds"

​
templateId
string