Personas

Create a persona

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.

post/personas

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/personas
  • Auth: API key in header X-Api-Key

Request body

face_idsstring[]

Ids from POST /personas/faces, uploaded in the last 24 hours.

Response

Response for status 202

idstring required
namestring required

Empty until the persona is saved.

status'draft' | 'ready' required
uses_face_photosboolean required

true when the persona was made from reference photos: the face, skin, eyes and hair come from them.

preset_idstring nullable required

The ready-made character this persona started from. Such a persona stays that character: chips are ignored on regenerate, a note still edits it.

image_status'generating' | 'ready' | 'failed' required
error_code'MEDIA_REJECTED' | 'COPYRIGHT_BLOCKED' | 'REAL_FACES_BLOCKED' | 'SAFETY_BLOCKED' | 'MEDIA_FAILED' | 'MEDIA_UNAVAILABLE' | 'INSUFFICIENT_CREDITS' | 'TIMEOUT' | 'OUTPUT_CHECK_FAILED' nullable required

Why the last generation failed, null otherwise: COPYRIGHT_BLOCKED (the scene looks like copyrighted material), REAL_FACES_BLOCKED (a real face is too prominent), SAFETY_BLOCKED (the provider's content rules) and MEDIA_REJECTED (refused for another reason); for any refusal change the traits, the photos or the video. MEDIA_FAILED and MEDIA_UNAVAILABLE (generation broke, retry), INSUFFICIENT_CREDITS, TIMEOUT, OUTPUT_CHECK_FAILED (the video did not keep the persona on the right person even after one free redo; try another video or pick the person). Credits of a failed generation are refunded automatically.

image_urlstring nullable required

Signed URL of the persona photo (close-up and full body side by side). Valid for one hour.

Changes

No recorded changes to this operation across all 1 revision of this API.