Skip to main content
POST
Generate a project

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

ID of one of your team's templates to base the project on. The template's design is preserved exactly and its slides are reproduced with your content. Only team templates are supported.

referenceImageUrls
string<uri>[]

Public image URLs to use as visual inspiration.

Maximum array length: 20
model
enum<string>

Generation model. Defaults to Gemini 3.6 Flash.

Available options:
google/gemini-3.6-flash,
openai/gpt-5.6-sol:xhigh

Response

Job created

jobId
string
required

Poll this ID with the status endpoint.

status
enum<string>
required
Available options:
processing,
completed,
failed
editorUrl
string<uri> | null
required

URL to open the project in the Faces editor.

estimatedDuration
string
required

Estimated generation time. ~120s with a team template, 240s from scratch.

Example:

"240 seconds"

projectId
string | null
required
projectSlug
string | null
required
templateId
string