Get traits, prices and limits
Everything a client needs to build the persona form without hardcoding it: every trait option, the defaults, which traits still apply when reference photos are used, the prices in credits and the limits of a source video. Prices follow what the models cost and can change at any time, so read them from here.
apiKeyX-Api-Key<token>Response for status 200
application/json- response
chip_options*Trait group (the keys of chips) to the options it accepts.
default_chips*One option per trait group. GET /personas/catalog lists every option and the defaults.
face_photo_groups*array<string>Trait groups that still apply when the persona is made from face photos. The others are ignored: the photos decide them. In these groups photo keeps the trait as the photos show it; without photos it falls back to the default.
max_face_photos*numberMost reference photos one persona accepts.
video_styles*array<>Values style accepts in GET /personas/swap/quote and POST /personas/{id}/videos.
pricing*video_limits*curl -X GET 'https://api.cut.pro/api/v1/personas/catalog'{ "chip_options": { "property1": [ "string" ], "property2": [ "string" ] }, "default_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" }, "face_photo_groups": [ "string" ], "max_face_photos": 0, "video_styles": [ "cel" ], "pricing": { "photo_credits": 0, "photo_with_references_credits": 0, "scene_photo_credits": 0, "video_economy_credits_per_second": 0, "video_standard_credits_per_second": 0, "video_short_max_seconds": 0, "video_short_credits_per_second": 0, "video_mid_max_seconds": 0, "video_mid_credits_per_second": 0, "video_long_credits_per_second": 0 }, "video_limits": { "min_seconds": 0, "max_seconds": 0, "standard": { "max_seconds": 0, "max_file_size": 0, "extensions": [ "string" ] }, "max_file_size": 0, "min_side": 0, "max_side": 0, "extensions": [ "string" ] }}Download the transcript as a subtitle file GET
Returns the transcript as a ready-to-use subtitle file (`srt` by default, `vtt` or `txt`) with the matching `Content-Type` and a `Content-Disposition` filename. The body is the file itself, not JSON. Speaker names are written into the file only when the job was billed with `speaker_labels`; pass `speakers=false` to leave them out of a diarized transcript. Returns `409 TRANSCRIPTION_NOT_READY` while the worker is still running. Keep polling `GET /transcriptions/{transcriptionId}`.
List ready-made characters GET
Characters whose photo already exists. `POST /personas/presets/{presetId}/use` turns one into a persona for free, ready to name, save and use in videos. `favorite` is the key's user's star, set with `PUT /personas/presets/{presetId}/favorite`.