Skip to Content
Cut.ProDocs
AI characters

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.

Authorization

apiKey
headerX-Api-Key<token>

Path Parameters

id*string

Query Parameters

page?number

Page number (default: 1)

Range1 <= value
limit?number

Items per page (default: 20, max: 100)

Range1 <= value <= 100
version_id?string

Only the videos made from this persona version.

Response Body

Response for status 200

application/json
  1. response
videos*array<>
pagination*
GET
/personas/{id}/videos
Example Request
curl -X GET 'https://api.cut.pro/api/v1/personas/string/videos'
Example Response200
{  "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.