Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Create a character

POST
/videos/characters

Create a character from an uploaded video.

Create a character

curl https://api.openai.com/v1/videos/characters \
    -H 'Content-Type: multipart/form-data' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -F name=x \
    -F 'video=@/path/to/video'
200 — Example
{
  "id": "id",
  "created_at": 0,
  "name": "name"
}
Body Parameters
Form Data
name: string

Display name for this API character.

minLength1
maxLength80
video: file

Video file used to create a character.

Returns
id: string or null

Identifier for the character creation cameo.

created_at: integer

Unix timestamp (in seconds) when the character was created.

formatunixtime
name: string or null

Display name for the character.

Returns Examples
200 — Example
{
  "id": "id",
  "created_at": 0,
  "name": "name"
}