Personas

Regenerate or edit the persona photo

Generates the photo again, for drafts and saved personas alike. Send new chips to change traits, nothing to try again with the same ones, or a one-line note (for example make the jacket red) to edit the current photo keeping the same person. When it finishes, the new photo becomes a new version and the current one; the traits change only then, so a failed generation leaves the persona as it was. Earlier versions stay in versions and videos already made keep their photo. Charged like a new photo; a note is priced as photo_with_references_credits.

CARD_LOCKED means a photo is already generating, or a note was sent before the first photo exists.

post/personas/{id}/regenerate

Request

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

Path parameters

idstring required

Request body

notestring

One-line change applied over the current photo.

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.