Cut.ProDocs
Personas

Get a persona video

Returns one persona video. Poll it every 10 seconds while status is processing; download_url is set once ready.

Authorization

apiKey
X-Api-Key<token>

In: header

Path Parameters

id*string
videoId*string

Response Body

application/json

application/json

GET
/personas/{id}/videos/{videoId}
curl -X GET "https://example.com/personas/string/videos/string"
{  "id": "string",  "type": "swap",  "quality": "standard",  "replace": "head",  "status": "processing",  "version_id": "string",  "duration_seconds": 0,  "credits_charged": 0,  "edit_id": "string",  "download_url": "string",  "thumbnail_url": "string",  "expected_seconds": 0,  "error_code": "MEDIA_REJECTED",  "feedback": "up",  "feedback_reason": "string",  "created_at": "string"}

Create a persona video POST

Starts a video with a saved persona. `type` picks the kind of video; today the only one is `swap`, which keeps the scene, camera, motion and sound of a library video and replaces its main person with the persona. `quality` (default `standard`) and `replace` (default `person`) pick how; quote and create with the same `quality`. `version_id` picks which of the persona's `versions` to use, the current one when left out. Charged per second of the source, even on a workspace with unlimited usage, and refunded automatically if it fails. Price it first with `GET /personas/swap/quote` and send that `credits`: when the server measures a different price it refuses with `409 PRICE_CHANGED` and the right one in `extra`, so nothing is ever charged above what was confirmed. Responds `202`. Poll `GET /personas/{id}/videos/{videoId}` every 10 seconds until `ready` or `failed`; the result also lands in the library with an `edit_id` for `POST /renders` and `POST /posts`. `VIDEO_IN_PROGRESS` means this persona is already working on the same version with the same video.