Skip to Content
Cut.ProDocs
AI characters

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.

Authorization

apiKey
headerX-Api-Key<token>

Path Parameters

id*string

Request Body

  1. body
chips?

One option per trait group. GET /personas/catalog lists every option and the defaults.

note?string

One-line change applied over the current photo.

Length1 <= length <= 120

Response Body

Response for status 202

application/json
  1. response
id*string
name*string

Empty until the persona is saved.

status*string
Value in"draft""ready"
chips*

One option per trait group. GET /personas/catalog lists every option and the defaults.

uses_face_photos*boolean

true 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
Value in"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.

Default"MEDIA_REJECTED"
Value in"MEDIA_REJECTED""COPYRIGHT_BLOCKED""REAL_FACES_BLOCKED""SAFETY_BLOCKED""MEDIA_FAILED""MEDIA_UNAVAILABLE""INSUFFICIENT_CREDITS""TIMEOUT""OUTPUT_CHECK_FAILED""TARGET_NOT_A_PERSON"null
image_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.

POST
/personas/{id}/regenerate
Example Request
curl -X POST 'https://api.cut.pro/api/v1/personas/string/regenerate' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "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"    }  ]}