List a persona's videos
Returns the videos made with this persona, newest first, with signed download URLs for the finished ones. version_id keeps only the videos made from that version.
apiKeyX-Api-Key<token>id*stringpage?numberPage number (default: 1)
1 <= valuelimit?numberItems per page (default: 20, max: 100)
1 <= value <= 100version_id?stringOnly the videos made from this persona version.
Response for status 200
application/json- response
videos*array<>pagination*curl -X GET 'https://api.cut.pro/api/v1/personas/string/videos'{ "videos": [ { "id": "string", "type": "swap", "quality": "economy", "replace": "head", "style": "cel", "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" } ], "pagination": { "current_page": 0, "total_pages": 0, "total_count": 0, "has_next_page": true, "has_previous_page": true, "limit": 0 }}Save or rename a persona POST
Approves the current photo and names the persona, which can then be used in videos. On a persona already saved it only renames it. The photo can still be regenerated or edited later, as new versions. `CARD_NOT_READY` means a draft whose photo is not `ready` yet.
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; `style` (none by default) redraws it in a drawing technique; quote and create with the same `quality` and `style`. `version_id` picks which of the persona's `versions` to use, the current one when left out. Charged per second of the source, scenes of the person included, even on a workspace with unlimited usage, and refunded automatically if it fails. Picking a `target` never raises the price above the quote. 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, and `POST /generations/{id}/edit` with the video's `id` gives the `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.