SpyBara
Go Premium

python/resources/videos/methods/create_character/index.md 2026-05-02 05:57 UTC to 2026-05-05 23:00 UTC

59 added, 0 removed.

2026
Wed 27 06:42 Fri 22 06:33 Wed 20 06:35 Tue 19 06:34 Mon 18 22:01 Mon 11 18:00 Thu 7 21:57 Tue 5 23:00 Sat 2 05:57
Data Information:
  • After 2026-05-05 06:03 UTC, this monitor no longer uses markdownified HTML/MDX. Comparisons across that boundary can therefore show more extensive diffs.

Create a character from an uploaded video.

videos.create_character(VideoCreateCharacterParams**kwargs) -> VideoCreateCharacterResponse

post /videos/characters

Create a character from an uploaded video.

Parameters

  • name: str

    Display name for this API character.

  • video: FileTypes

    Video file used to create a character.

Returns

  • class VideoCreateCharacterResponse: …

    • id: Optional[str]

      Identifier for the character creation cameo.

    • created_at: int

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

    • name: Optional[str]

      Display name for the character.

Example

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
response = client.videos.create_character(
    name="x",
    video=b"Example data",
)
print(response.id)

Response

{
  "id": "id",
  "created_at": 0,
  "name": "name"
}