resources/videos/methods/create_character/index.md 2026-09-10 18:01 UTC to 2026-09-11 20:00 UTC

Create a character

post /videos/characters

Create a character from an uploaded video.

Returns

• id: string or null

  Identifier for the character creation cameo.

• created_at: number

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

• name: string or null

  Display name for the character.

Example

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'

Response

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