List personas
Returns the workspace's personas, newest first, drafts included. image_status and video_generating say what is still being generated, so one call shows every persona in progress.
Authorization
apiKey In: header
Query Parameters
Page number (default: 1)
1 <= valueItems per page (default: 20, max: 100)
1 <= value <= 100Response Body
application/json
curl -X GET "https://example.com/personas"{ "personas": [ { "id": "string", "name": "string", "status": "draft", "image_status": "generating", "video_generating": true, "face_url": "string", "created_at": "string" } ], "pagination": { "current_page": 0, "total_pages": 0, "total_count": 0, "has_next_page": true, "has_previous_page": true, "limit": 0 }}Star a ready-made character PUT
`favorite: true` stars the character for the key's user, `false` removes the star.
Create a persona POST
Creates a draft persona and starts generating its photo: a close-up portrait and a full-body shot of the same person. Credits are charged now (see `GET /personas/catalog`), even on a workspace with unlimited usage, and refunded if the photo fails. With `face_ids` the persona keeps the identity of the person in the photos, and only the traits listed in `face_photo_groups` are applied. Responds `202` with `image_status: generating`. Poll `GET /personas/{id}` every 5 seconds until it is `ready` or `failed`.