## Create a character from an uploaded video.

`$ openai videos create-character`

**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

- `VideoNewCharacterResponse: object { id, created_at, name }`

  - `id: string`

    Identifier for the character creation cameo.

  - `created_at: number`

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

  - `name: string`

    Display name for the character.

### Example

```cli
openai videos create-character \
  --api-key 'My API Key' \
  --name x \
  --video 'Example data'
```

#### Response

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