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 In: header
Path Parameters
Query Parameters
Page number (default: 1)
1 <= valueItems per page (default: 20, max: 100)
1 <= value <= 100Only the videos made from this persona version.
Response Body
application/json
curl -X GET "https://example.com/personas/string/videos"{ "videos": [ { "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" } ], "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; 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.