Create a Character from an Uploaded Video

POST https://www.kkiai.com/v1/videos/characters

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value should be the Token concatenated after Bearer.

Example: Authorization: Bearer ********************

Body Parameters (multipart/form-data)

Parameter	Type	Required	Description
name	string	Required	Define the character name. Maximum length 80, minimum length 1
video	file	Required	Video file used to create the character. Currently, video clips of 2 to 4 seconds work best for character uploads. Aspect ratio should be 16:9 or 9:16, with resolution between 720p and 1080p. The character source video works best when matching the required output aspect ratio. If the aspect ratio differs, the character may appear stretched or distorted. A single video can contain up to two characters.

cURL Example

curl --location --request POST 'https://www.kkiai.com/v1/videos/characters' \
--header 'Authorization: Bearer <token>' \
--form 'name="Cute little fish."' \
--form 'video=@"C:\\Users\\Administrator\\Desktop\\download.mp4"'

Response

🟢 200 Success

Response Example

{
    "id": "video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980",
    "object": "video",
    "model": "sora-2",
    "status": "queued",
    "progress": 0,
    "created_at": 1761622232,
    "seconds": "10",
    "size": "1280x720"
}