python/resources/videos/methods/create_character/index.md +0 −59 deleted
File Deleted View Diff
1## Create a character from an uploaded video.
2
3`videos.create_character(VideoCreateCharacterParams**kwargs) -> VideoCreateCharacterResponse`
4
5**post** `/videos/characters`
6
7Create a character from an uploaded video.
8
9### Parameters
10
11- `name: str`
12
13 Display name for this API character.
14
15- `video: FileTypes`
16
17 Video file used to create a character.
18
19### Returns
20
21- `class VideoCreateCharacterResponse: …`
22
23 - `id: Optional[str]`
24
25 Identifier for the character creation cameo.
26
27 - `created_at: int`
28
29 Unix timestamp (in seconds) when the character was created.
30
31 - `name: Optional[str]`
32
33 Display name for the character.
34
35### Example
36
37```python
38import os
39from openai import OpenAI
40
41client = OpenAI(
42 api_key=os.environ.get("OPENAI_API_KEY"), # This is the default and can be omitted
43)
44response = client.videos.create_character(
45 name="x",
46 video=b"Example data",
47)
48print(response.id)
49```
50
51#### Response
52
53```json
54{
55 "id": "id",
56 "created_at": 0,
57 "name": "name"
58}
59```