Identities

Generate identity drafts

POST
/identity/create

Generates draft face images from a list of instructions. Drafts do not create Identity records or consume identity slots. Use POST /identity/promote-generated to graduate a specific draft into a full identity.

Authorization

token_auth
headerAuthorizationBearer <token>

Token-based authentication using access tokens.

Request Body

application/json
  1. body
instructions*array<>

One or more instructions. Each produces its own set of variations.

options?|

Job-level options (currently just the generation model).

Defaultnull
name?|

Optional job-level label.

Defaultnull
tag?|

Optional job-level tag.

Defaultnull

Response Body

Successful Response

application/json
  1. response
job_id*Job Id
status*Status
num_instructions*Num Instructions
total_variations*Total Variations
message*Message
curl -X POST "https://example.com/identity/create" \  -H "Content-Type: application/json" \  -d '{    "instructions": [      {}    ]  }'
{  "job_id": "string",  "status": "string",  "num_instructions": 0,  "total_variations": 0,  "message": "string"}