magic_hour 0.9.5__py3-none-any.whl → 0.44.0__py3-none-any.whl

magic_hour/types/params/v1_ai_voice_generator_create_body_style.py

@@ -0,0 +1,440 @@
+import pydantic
+import typing_extensions
+
+
+class V1AiVoiceGeneratorCreateBodyStyle(typing_extensions.TypedDict):
+    """
+    The content used to generate speech.
+    """
+
+    prompt: typing_extensions.Required[str]
+    """
+    Text used to generate speech. Starter tier users can use up to 1000 characters, while Creator, Pro, or Business users can use up to 1000.
+    """
+
+    voice_name: typing_extensions.Required[
+        typing_extensions.Literal[
+            "A.R. Rahman",
+            "Aamir Khan",
+            "Abraham Lincoln",
+            "Adam Driver",
+            "Ajay Devgn",
+            "Akshay Kumar",
+            "Alain Delon",
+            "Alan Alda",
+            "Alan Cumming",
+            "Alan Rickman",
+            "Albert Einstein",
+            "Alex Trebek",
+            "Alexz Johnson",
+            "Amitabh Bachchan",
+            "Amy Poehler",
+            "Ana Gasteyer",
+            "Andrew Rannells",
+            "Ang Lee",
+            "Anne Hathaway",
+            "Ansel Elgort",
+            "Anthony Anderson",
+            "Anthony Mackie",
+            "Arden Cho",
+            "Armie Hammer",
+            "Asa Butterfield",
+            "B.J. Novak",
+            "Barack Obama",
+            "Barbara Eden",
+            "Bear Grylls",
+            "Ben McKenzie",
+            "Ben Stiller",
+            "Ben Whishaw",
+            "Betty White",
+            "Bill Nighy",
+            "Bill Pullman",
+            "Billie Joe Armstrong",
+            "Bingbing Li",
+            "Blake Shelton",
+            "Bob Barker",
+            "Bonnie Wright",
+            "Booboo Stewart",
+            "Brad Paisley",
+            "Bradley Steven Perry",
+            "Brendan Gleeson",
+            "Brian Cox",
+            "Bruno Ganz",
+            "Bruno Mars",
+            "Burt Reynolds",
+            "Caitriona Balfe",
+            "Caity Lotz",
+            "Cameron Boyce",
+            "Candice Accola",
+            "Carrie Fisher",
+            "Carrie Underwood",
+            "Casey Affleck",
+            "Caterina Scorsone",
+            "Cedric the Entertainer",
+            "Chace Crawford",
+            "Chadwick Boseman",
+            "Charles Dance",
+            "Charlie Chaplin",
+            "Charlie Day",
+            "Chiwetel Ejiofor",
+            "Chris Hemsworth",
+            "Chris Martin",
+            "Chris Pine",
+            "Christina Hendricks",
+            "Christina Ricci",
+            "Christopher Mintz-Plasse",
+            "Cillian Murphy",
+            "Cyndi Lauper",
+            "Dakota Fanning",
+            "Damian Lewis",
+            "Dan Aykroyd",
+            "Dan Fogler",
+            "Dan Stevens",
+            "Daniel Craig",
+            "Daniel Dae Kim",
+            "Danielle Panabaker",
+            "Dave Bautista",
+            "David Attenborough",
+            "David Letterman",
+            "David Oyelowo",
+            "David Schwimmer",
+            "David Tennant",
+            "Denis Leary",
+            "Derek Mears",
+            "Diane Keaton",
+            "Diane Kruger",
+            "Dick Van Dyke",
+            "Diego Luna",
+            "Domhnall Gleeson",
+            "Dominic Cooper",
+            "Donald Glover",
+            "Donald Sutherland",
+            "Donald Trump",
+            "Donnie Yen",
+            "Doutzen Kroes",
+            "Dove Cameron",
+            "Dr. Dre",
+            "Drake Bell",
+            "Drew Carey",
+            "Eartha Kitt",
+            "Eddie Izzard",
+            "Edward Asner",
+            "Eli Roth",
+            "Elisabeth Moss",
+            "Elle Fanning",
+            "Ellen Burstyn",
+            "Elon Musk",
+            "Emile Hirsch",
+            "Ernie Hudson",
+            "Ezra Miller",
+            "Felicity Jones",
+            "Fergie",
+            "Fiona Shaw",
+            "Florence Henderson",
+            "Forest Whitaker",
+            "Francia Raisa",
+            "Freddie Highmore",
+            "Freida Pinto",
+            "Geena Davis",
+            "Gemma Arterton",
+            "Geri Halliwell",
+            "Gillian Jacobs",
+            "Gina Carano",
+            "Ginnifer Goodwin",
+            "Glenn Close",
+            "Gloria Steinem",
+            "Gordon Ramsay",
+            "Greta Gerwig",
+            "Gugu Mbatha-Raw",
+            "Guy Pearce",
+            "Gwendoline Christie",
+            "Hailee Steinfeld",
+            "Hans Zimmer",
+            "Harry Connick Jr.",
+            "Harvey Keitel",
+            "Helena Bonham Carter",
+            "Henry Cavill",
+            "Hilary Swank",
+            "Howie Mandel",
+            "Hugh Bonneville",
+            "Hugh Jackman",
+            "Hugh Laurie",
+            "Idina Menzel",
+            "Imelda Staunton",
+            "Ingrid Bergman",
+            "Irrfan Khan",
+            "Isla Fisher",
+            "Iwan Rheon",
+            "J. K. Simmons",
+            "J.J. Abrams",
+            "Jack Black",
+            "Jack Lemmon",
+            "James Earl Jones",
+            "Janet Jackson",
+            "Jared Leto",
+            "Jason Bateman",
+            "Jason Segel",
+            "Jeff Goldblum",
+            "Jennifer Carpenter",
+            "Jennifer Coolidge",
+            "Jimmy Fallon",
+            "Joe Biden",
+            "Joe Rogan",
+            "John F. Kennedy",
+            "Johnny Galecki",
+            "Jon Favreau",
+            "Joseph Gordon-Levitt",
+            "Josh Brolin",
+            "Josh Gad",
+            "Josh Groban",
+            "Julia Louis-Dreyfus",
+            "Julia Roberts",
+            "Kanye West",
+            "Katy Perry",
+            "Kesha",
+            "Kevin Bacon",
+            "Kim Kardashian",
+            "Kris Jenner",
+            "Kristen Bell",
+            "Kristen Stewart",
+            "Kristen Wiig",
+            "Lorde",
+            "Lucille Ball",
+            "Marilyn Monroe",
+            "Mark Zuckerberg",
+            "Matt Smith",
+            "Morgan Freeman",
+            "Natalie Portman",
+            "Prince",
+            "Rooney Mara",
+            "Samuel L. Jackson",
+            "Sean Connery",
+            "Stephen Colbert",
+            "Steve Carell",
+            "Taylor Swift",
+            "Tom Hiddleston",
+            "Zoe Saldana",
+        ]
+    ]
+    """
+    The voice to use for the speech. Available voices: Elon Musk, Mark Zuckerberg, Joe Rogan, Barack Obama, Morgan Freeman, Kanye West, Donald Trump, Joe Biden, Kim Kardashian, Taylor Swift, James Earl Jones, Samuel L. Jackson, Jeff Goldblum, David Attenborough, Sean Connery, Cillian Murphy, Anne Hathaway, Julia Roberts, Natalie Portman, Steve Carell, Amy Poehler, Stephen Colbert, Jimmy Fallon, David Letterman, Alex Trebek, Katy Perry, Prince, Kevin Bacon, Tom Hiddleston, Adam Driver, Alan Rickman, Alexz Johnson, Ana Gasteyer, Andrew Rannells, Arden Cho, Bear Grylls, Ben McKenzie, Ben Stiller, Ben Whishaw, Billie Joe Armstrong, Bingbing Li, Bob Barker, Booboo Stewart, Bradley Steven Perry, Bruno Mars, Caity Lotz, Cameron Boyce, Candice Accola, Carrie Underwood, Casey Affleck, Caterina Scorsone, Cedric the Entertainer, Chace Crawford, Chadwick Boseman, Charlie Day, Chris Hemsworth, Chris Martin, Christopher Mintz-Plasse, Dan Fogler, Dan Stevens, Daniel Dae Kim, Danielle Panabaker, Dave Bautista, David Schwimmer, Denis Leary, Derek Mears, Diego Luna, Donald Glover, Donnie Yen, Doutzen Kroes, Dove Cameron, Dr. Dre, Drake Bell, Elle Fanning, Ernie Hudson, Fergie, Forest Whitaker, Francia Raisa, Freddie Highmore, Gillian Jacobs, Gina Carano, Ginnifer Goodwin, Gordon Ramsay, Guy Pearce, Gwendoline Christie, Hailee Steinfeld, Howie Mandel, Hugh Jackman, Hugh Laurie, J. K. Simmons, Jack Black, Jared Leto, Jennifer Carpenter, Kesha, Kris Jenner, Kristen Bell, Lorde, Matt Smith, Marilyn Monroe, Charlie Chaplin, Albert Einstein, Abraham Lincoln, John F. Kennedy, Lucille Ball, A.R. Rahman, Aamir Khan, Ajay Devgn, Akshay Kumar, Alain Delon, Alan Alda, Alan Cumming, Amitabh Bachchan, Ang Lee, Ansel Elgort, Anthony Anderson, Anthony Mackie, Armie Hammer, Asa Butterfield, B.J. Novak, Barbara Eden, Betty White, Bill Nighy, Bill Pullman, Blake Shelton, Bonnie Wright, Brad Paisley, Brendan Gleeson, Brian Cox, Bruno Ganz, Burt Reynolds, Carrie Fisher, Charles Dance, Chiwetel Ejiofor, Chris Pine, Christina Hendricks, Christina Ricci, Cyndi Lauper, Dakota Fanning, Damian Lewis, Dan Aykroyd, Daniel Craig, David Oyelowo, David Tennant, Diane Keaton, Diane Kruger, Dick Van Dyke, Domhnall Gleeson, Dominic Cooper, Donald Sutherland, Drew Carey, Eartha Kitt, Eddie Izzard, Edward Asner, Eli Roth, Elisabeth Moss, Ellen Burstyn, Emile Hirsch, Ezra Miller, Felicity Jones, Fiona Shaw, Florence Henderson, Freida Pinto, Geena Davis, Gemma Arterton, Geri Halliwell, Glenn Close, Gloria Steinem, Greta Gerwig, Gugu Mbatha-Raw, Hans Zimmer, Harry Connick Jr., Harvey Keitel, Helena Bonham Carter, Henry Cavill, Hilary Swank, Hugh Bonneville, Idina Menzel, Imelda Staunton, Ingrid Bergman, Irrfan Khan, Isla Fisher, Iwan Rheon, Jack Lemmon, Janet Jackson, Jason Bateman, Jason Segel, Jennifer Coolidge, Johnny Galecki, Jon Favreau, Joseph Gordon-Levitt, Josh Brolin, Josh Gad, Josh Groban, Julia Louis-Dreyfus, Kristen Stewart, Kristen Wiig, Rooney Mara, Caitriona Balfe, J.J. Abrams, Zoe Saldana
+    """
+
+
+class _SerializerV1AiVoiceGeneratorCreateBodyStyle(pydantic.BaseModel):
+    """
+    Serializer for V1AiVoiceGeneratorCreateBodyStyle handling case conversions
+    and file omissions as dictated by the API
+    """
+
+    model_config = pydantic.ConfigDict(
+        populate_by_name=True,
+    )
+
+    prompt: str = pydantic.Field(
+        alias="prompt",
+    )
+    voice_name: typing_extensions.Literal[
+        "A.R. Rahman",
+        "Aamir Khan",
+        "Abraham Lincoln",
+        "Adam Driver",
+        "Ajay Devgn",
+        "Akshay Kumar",
+        "Alain Delon",
+        "Alan Alda",
+        "Alan Cumming",
+        "Alan Rickman",
+        "Albert Einstein",
+        "Alex Trebek",
+        "Alexz Johnson",
+        "Amitabh Bachchan",
+        "Amy Poehler",
+        "Ana Gasteyer",
+        "Andrew Rannells",
+        "Ang Lee",
+        "Anne Hathaway",
+        "Ansel Elgort",
+        "Anthony Anderson",
+        "Anthony Mackie",
+        "Arden Cho",
+        "Armie Hammer",
+        "Asa Butterfield",
+        "B.J. Novak",
+        "Barack Obama",
+        "Barbara Eden",
+        "Bear Grylls",
+        "Ben McKenzie",
+        "Ben Stiller",
+        "Ben Whishaw",
+        "Betty White",
+        "Bill Nighy",
+        "Bill Pullman",
+        "Billie Joe Armstrong",
+        "Bingbing Li",
+        "Blake Shelton",
+        "Bob Barker",
+        "Bonnie Wright",
+        "Booboo Stewart",
+        "Brad Paisley",
+        "Bradley Steven Perry",
+        "Brendan Gleeson",
+        "Brian Cox",
+        "Bruno Ganz",
+        "Bruno Mars",
+        "Burt Reynolds",
+        "Caitriona Balfe",
+        "Caity Lotz",
+        "Cameron Boyce",
+        "Candice Accola",
+        "Carrie Fisher",
+        "Carrie Underwood",
+        "Casey Affleck",
+        "Caterina Scorsone",
+        "Cedric the Entertainer",
+        "Chace Crawford",
+        "Chadwick Boseman",
+        "Charles Dance",
+        "Charlie Chaplin",
+        "Charlie Day",
+        "Chiwetel Ejiofor",
+        "Chris Hemsworth",
+        "Chris Martin",
+        "Chris Pine",
+        "Christina Hendricks",
+        "Christina Ricci",
+        "Christopher Mintz-Plasse",
+        "Cillian Murphy",
+        "Cyndi Lauper",
+        "Dakota Fanning",
+        "Damian Lewis",
+        "Dan Aykroyd",
+        "Dan Fogler",
+        "Dan Stevens",
+        "Daniel Craig",
+        "Daniel Dae Kim",
+        "Danielle Panabaker",
+        "Dave Bautista",
+        "David Attenborough",
+        "David Letterman",
+        "David Oyelowo",
+        "David Schwimmer",
+        "David Tennant",
+        "Denis Leary",
+        "Derek Mears",
+        "Diane Keaton",
+        "Diane Kruger",
+        "Dick Van Dyke",
+        "Diego Luna",
+        "Domhnall Gleeson",
+        "Dominic Cooper",
+        "Donald Glover",
+        "Donald Sutherland",
+        "Donald Trump",
+        "Donnie Yen",
+        "Doutzen Kroes",
+        "Dove Cameron",
+        "Dr. Dre",
+        "Drake Bell",
+        "Drew Carey",
+        "Eartha Kitt",
+        "Eddie Izzard",
+        "Edward Asner",
+        "Eli Roth",
+        "Elisabeth Moss",
+        "Elle Fanning",
+        "Ellen Burstyn",
+        "Elon Musk",
+        "Emile Hirsch",
+        "Ernie Hudson",
+        "Ezra Miller",
+        "Felicity Jones",
+        "Fergie",
+        "Fiona Shaw",
+        "Florence Henderson",
+        "Forest Whitaker",
+        "Francia Raisa",
+        "Freddie Highmore",
+        "Freida Pinto",
+        "Geena Davis",
+        "Gemma Arterton",
+        "Geri Halliwell",
+        "Gillian Jacobs",
+        "Gina Carano",
+        "Ginnifer Goodwin",
+        "Glenn Close",
+        "Gloria Steinem",
+        "Gordon Ramsay",
+        "Greta Gerwig",
+        "Gugu Mbatha-Raw",
+        "Guy Pearce",
+        "Gwendoline Christie",
+        "Hailee Steinfeld",
+        "Hans Zimmer",
+        "Harry Connick Jr.",
+        "Harvey Keitel",
+        "Helena Bonham Carter",
+        "Henry Cavill",
+        "Hilary Swank",
+        "Howie Mandel",
+        "Hugh Bonneville",
+        "Hugh Jackman",
+        "Hugh Laurie",
+        "Idina Menzel",
+        "Imelda Staunton",
+        "Ingrid Bergman",
+        "Irrfan Khan",
+        "Isla Fisher",
+        "Iwan Rheon",
+        "J. K. Simmons",
+        "J.J. Abrams",
+        "Jack Black",
+        "Jack Lemmon",
+        "James Earl Jones",
+        "Janet Jackson",
+        "Jared Leto",
+        "Jason Bateman",
+        "Jason Segel",
+        "Jeff Goldblum",
+        "Jennifer Carpenter",
+        "Jennifer Coolidge",
+        "Jimmy Fallon",
+        "Joe Biden",
+        "Joe Rogan",
+        "John F. Kennedy",
+        "Johnny Galecki",
+        "Jon Favreau",
+        "Joseph Gordon-Levitt",
+        "Josh Brolin",
+        "Josh Gad",
+        "Josh Groban",
+        "Julia Louis-Dreyfus",
+        "Julia Roberts",
+        "Kanye West",
+        "Katy Perry",
+        "Kesha",
+        "Kevin Bacon",
+        "Kim Kardashian",
+        "Kris Jenner",
+        "Kristen Bell",
+        "Kristen Stewart",
+        "Kristen Wiig",
+        "Lorde",
+        "Lucille Ball",
+        "Marilyn Monroe",
+        "Mark Zuckerberg",
+        "Matt Smith",
+        "Morgan Freeman",
+        "Natalie Portman",
+        "Prince",
+        "Rooney Mara",
+        "Samuel L. Jackson",
+        "Sean Connery",
+        "Stephen Colbert",
+        "Steve Carell",
+        "Taylor Swift",
+        "Tom Hiddleston",
+        "Zoe Saldana",
+    ] = pydantic.Field(
+        alias="voice_name",
+    )

magic_hour/types/params/{post_v1_animation_body.py → v1_animation_create_body.py}

@@ -2,29 +2,29 @@ import pydantic
 import typing
 import typing_extensions
 
-from .post_v1_animation_body_assets import (
-    PostV1AnimationBodyAssets,
-    _SerializerPostV1AnimationBodyAssets,
+from .v1_animation_create_body_assets import (
+    V1AnimationCreateBodyAssets,
+    _SerializerV1AnimationCreateBodyAssets,
 )
-from .post_v1_animation_body_style import (
-    PostV1AnimationBodyStyle,
-    _SerializerPostV1AnimationBodyStyle,
+from .v1_animation_create_body_style import (
+    V1AnimationCreateBodyStyle,
+    _SerializerV1AnimationCreateBodyStyle,
 )
 
 
-class PostV1AnimationBody(typing_extensions.TypedDict):
+class V1AnimationCreateBody(typing_extensions.TypedDict):
     """
-    PostV1AnimationBody
+    V1AnimationCreateBody
     """
 
-    assets: typing_extensions.Required[PostV1AnimationBodyAssets]
+    assets: typing_extensions.Required[V1AnimationCreateBodyAssets]
     """
     Provide the assets for animation.
     """
 
     end_seconds: typing_extensions.Required[float]
     """
-    The end time of the input video in seconds
+    This value determines the duration of the output video.
     """
 
     fps: typing_extensions.Required[float]
@@ -39,10 +39,10 @@ class PostV1AnimationBody(typing_extensions.TypedDict):
 
     name: typing_extensions.NotRequired[str]
     """
-    The name of video
+    The name of video. This value is mainly used for your own identification of the video.
     """
 
-    style: typing_extensions.Required[PostV1AnimationBodyStyle]
+    style: typing_extensions.Required[V1AnimationCreateBodyStyle]
     """
     Defines the style of the output video
     """
@@ -53,9 +53,9 @@ class PostV1AnimationBody(typing_extensions.TypedDict):
     """
 
 
-class _SerializerPostV1AnimationBody(pydantic.BaseModel):
+class _SerializerV1AnimationCreateBody(pydantic.BaseModel):
     """
-    Serializer for PostV1AnimationBody handling case conversions
+    Serializer for V1AnimationCreateBody handling case conversions
     and file omissions as dictated by the API
     """
 
@@ -63,7 +63,7 @@ class _SerializerPostV1AnimationBody(pydantic.BaseModel):
         populate_by_name=True,
     )
 
-    assets: _SerializerPostV1AnimationBodyAssets = pydantic.Field(
+    assets: _SerializerV1AnimationCreateBodyAssets = pydantic.Field(
         alias="assets",
     )
     end_seconds: float = pydantic.Field(
@@ -76,7 +76,7 @@ class _SerializerPostV1AnimationBody(pydantic.BaseModel):
         alias="height",
     )
     name: typing.Optional[str] = pydantic.Field(alias="name", default=None)
-    style: _SerializerPostV1AnimationBodyStyle = pydantic.Field(
+    style: _SerializerV1AnimationCreateBodyStyle = pydantic.Field(
         alias="style",
     )
     width: int = pydantic.Field(

magic_hour/types/params/{post_v1_animation_body_assets.py → v1_animation_create_body_assets.py}

@@ -3,14 +3,19 @@ import typing
 import typing_extensions
 
 
-class PostV1AnimationBodyAssets(typing_extensions.TypedDict):
+class V1AnimationCreateBodyAssets(typing_extensions.TypedDict):
     """
     Provide the assets for animation.
     """
 
     audio_file_path: typing_extensions.NotRequired[str]
     """
-    The path of the input audio. This field is required if `audio_source` is `file`. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
+    The path of the input audio. This field is required if `audio_source` is `file`. This value is either
+    - a direct URL to the video file
+    - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
+    
+    Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.
+    
     """
 
     audio_source: typing_extensions.Required[
@@ -22,7 +27,12 @@ class PostV1AnimationBodyAssets(typing_extensions.TypedDict):
 
     image_file_path: typing_extensions.NotRequired[str]
     """
-    An initial image to use a the first frame of the video. This value can be either the `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls), or the url of the file.
+    An initial image to use a the first frame of the video. This value is either
+    - a direct URL to the video file
+    - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls).
+    
+    Please refer to the [Input File documentation](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) to learn more.
+    
     """
 
     youtube_url: typing_extensions.NotRequired[str]
@@ -31,9 +41,9 @@ class PostV1AnimationBodyAssets(typing_extensions.TypedDict):
     """
 
 
-class _SerializerPostV1AnimationBodyAssets(pydantic.BaseModel):
+class _SerializerV1AnimationCreateBodyAssets(pydantic.BaseModel):
     """
-    Serializer for PostV1AnimationBodyAssets handling case conversions
+    Serializer for V1AnimationCreateBodyAssets handling case conversions
     and file omissions as dictated by the API
     """
 

magic_hour/types/params/{post_v1_animation_body_style.py → v1_animation_create_body_style.py}

@@ -3,7 +3,7 @@ import typing
 import typing_extensions
 
 
-class PostV1AnimationBodyStyle(typing_extensions.TypedDict):
+class V1AnimationCreateBodyStyle(typing_extensions.TypedDict):
     """
     Defines the style of the output video
     """
@@ -60,7 +60,7 @@ class PostV1AnimationBodyStyle(typing_extensions.TypedDict):
         ]
     ]
     """
-    The art style of the final output video
+    The art style used to create the output video
     """
 
     art_style_custom: typing_extensions.NotRequired[str]
@@ -124,8 +124,11 @@ class PostV1AnimationBodyStyle(typing_extensions.TypedDict):
             "Zoom Out - Audio Sync",
         ]
     ]
+    """
+    The camera effect used to create the output video
+    """
 
-    prompt: typing_extensions.Required[typing.Optional[str]]
+    prompt: typing_extensions.NotRequired[str]
     """
     The prompt used for the video. Prompt is required if `prompt_type` is `custom`. Otherwise this value is ignored
     """
@@ -135,20 +138,22 @@ class PostV1AnimationBodyStyle(typing_extensions.TypedDict):
     ]
     """
     
-    * `custom` - use your own prompt for the video.
+    * `custom` - Use your own prompt for the video.
     * `use_lyrics` - Use the lyrics of the audio to create the prompt. If this option is selected, then `assets.audio_source` must be `file` or `youtube`.
     * `ai_choose` - Let AI write the prompt. If this option is selected, then `assets.audio_source` must be `file` or `youtube`.
     """
 
     transition_speed: typing_extensions.Required[int]
     """
-    Change determines how quickly the video's content changes across frames. Higher = more rapid transitions. Lower = more stable visual experience.
+    Change determines how quickly the video's content changes across frames. 
+    * Higher = more rapid transitions.
+    * Lower = more stable visual experience.
     """
 
 
-class _SerializerPostV1AnimationBodyStyle(pydantic.BaseModel):
+class _SerializerV1AnimationCreateBodyStyle(pydantic.BaseModel):
     """
-    Serializer for PostV1AnimationBodyStyle handling case conversions
+    Serializer for V1AnimationCreateBodyStyle handling case conversions
     and file omissions as dictated by the API
     """
 
@@ -266,9 +271,7 @@ class _SerializerPostV1AnimationBodyStyle(pydantic.BaseModel):
     ] = pydantic.Field(
         alias="camera_effect",
     )
-    prompt: typing.Optional[str] = pydantic.Field(
-        alias="prompt",
-    )
+    prompt: typing.Optional[str] = pydantic.Field(alias="prompt", default=None)
     prompt_type: typing_extensions.Literal["ai_choose", "custom", "use_lyrics"] = (
         pydantic.Field(
             alias="prompt_type",

magic_hour/types/params/v1_animation_generate_body_assets.py

@@ -0,0 +1,39 @@
+import pydantic
+import typing
+import typing_extensions
+
+
+class V1AnimationGenerateBodyAssets(typing_extensions.TypedDict):
+    """
+    Provide the assets for animation.
+    """
+
+    audio_file_path: typing_extensions.NotRequired[str]
+    """
+    The path of the input audio. This field is required if `audio_source` is `file`. This value is either
+    - a direct URL to the video file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """
+
+    audio_source: typing_extensions.Required[
+        typing_extensions.Literal["file", "none", "youtube"]
+    ]
+    """
+    Optionally add an audio source if you'd like to incorporate audio into your video
+    """
+
+    image_file_path: typing_extensions.NotRequired[str]
+    """
+    An initial image to use a the first frame of the video. This value is either
+    - a direct URL to the image file
+    - a path to a local file
+
+    Note: if the path begins with `api-assets`, it will be assumed to already be uploaded to Magic Hour's storage, and will not be uploaded again.
+    """
+
+    youtube_url: typing_extensions.NotRequired[str]
+    """
+    Using a youtube video as the input source. This field is required if `audio_source` is `youtube`
+    """