SpyBara
Go Premium

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

This page contains 55 additions and 0 deletions.

2026
Wed 10 15:48

Create a character from an uploaded video.

videos.create_character(**kwargs) -> VideoCreateCharacterResponse

post /videos/characters

Create a character from an uploaded video.

Parameters

  • name: String

    Display name for this API character.

  • video: String

    Video file used to create a character.

Returns

  • class VideoCreateCharacterResponse

    • id: String

      Identifier for the character creation cameo.

    • created_at: Integer

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

    • name: String

      Display name for the character.

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

response = openai.videos.create_character(name: "x", video: StringIO.new("Example data"))

puts(response)

Response

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