Cut.ProDocs
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.

Authorization

apiKey
X-Api-Key<token>

In: header

Path Parameters

id*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

POST
/personas/{id}/regenerate
curl -X POST "https://example.com/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": "none",    "face": "none",    "body": "slim",    "outfit": "basic",    "accessory": "none",    "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"    }  ]}