Restore a persona version
Makes an earlier photo from versions the current one again, with the traits it was made from. Free and instant; new videos use the restored photo and videos already made are not touched. CARD_LOCKED means a photo is generating: wait for it to finish.
apiKeyX-Api-Key<token>id*stringversionId*stringResponse for status 200
application/json- response
id*stringname*stringEmpty until the persona is saved.
status*string"draft""ready"chips*One option per trait group. GET /personas/catalog lists every option and the defaults.
uses_face_photos*booleantrue when the persona was made from reference photos: the face, skin, eyes and hair come from them.
preset_id*|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*string"generating""ready""failed"error_code*|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), TARGET_NOT_A_PERSON (nobody was at the spot picked as target; pick a person). Credits of a failed generation are refunded automatically.
"MEDIA_REJECTED""MEDIA_REJECTED""COPYRIGHT_BLOCKED""REAL_FACES_BLOCKED""SAFETY_BLOCKED""MEDIA_FAILED""MEDIA_UNAVAILABLE""INSUFFICIENT_CREDITS""TIMEOUT""OUTPUT_CHECK_FAILED""TARGET_NOT_A_PERSON"nullimage_url*|Signed URL of the persona photo (close-up and full body side by side). Valid for one hour.
eta*|Only while image_status is generating.
versions*array<>Every photo the persona has had, newest first, up to 30. Each generation or edit that finishes adds one and makes it current.
curl -X POST 'https://api.cut.pro/api/v1/personas/string/versions/string/restore'{ "id": "string", "name": "string", "status": "draft", "chips": { "vibe": "natural", "gender": "female", "age": "18_24", "origin": "latin", "skin": "very_light", "eyes": "brown", "hair_style": "buzz", "hair_color": "black", "facial_hair": "photo", "face": "none", "body": "photo", "outfit": "photo", "accessory": "photo", "mark": "none" }, "uses_face_photos": true, "preset_id": "string", "image_status": "generating", "error_code": "MEDIA_REJECTED", "image_url": "string", "eta": { "started_at": "string", "expected_seconds": 0 }, "versions": [ { "id": "string", "current": true, "image_url": "string", "face_url": "string", "feedback": "up", "feedback_reason": "string", "created_at": "string" } ]}Regenerate or edit the persona photo POST
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.
Rate a persona photo POST
Records whether a photo from `versions` was liked. Send `down` with a `reason`, or `null` to clear the rating. Free; it only teaches us what to improve.