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.
apiKeyX-Api-Key<token>id*string- body
chips?One option per trait group. GET /personas/catalog lists every option and the defaults.
note?stringOne-line change applied over the current photo.
1 <= length <= 120Response for status 202
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/regenerate' \ -H 'Content-Type: application/json' \ -d '{}'{ "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" } ]}Delete a persona DELETE
Removes the persona and its videos from every listing. A generation still running finishes or is refunded as usual, and edits already created from its videos stay in the workspace.
Restore a persona version POST
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.