SpyBara
Go Premium

python/resources/videos/methods/create_character/index.md 2026-06-09 06:34 UTC to 2026-06-10 15:48 UTC

59 added, 0 removed.

2026
Wed 17 18:02 Tue 16 21:57 Fri 12 00:01 Wed 10 15:48 Tue 9 06:34 Fri 5 06:45 Thu 4 06:52 Tue 2 06:51

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"
}