feat(api): api update (#8)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 3
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beats-ai-beatsfoundation%2Fbeats-foundation-f711efcd99b00b3dc26c741770eecb8c17dc76bac1372c192aa232b4aae417e9.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beats-ai-beatsfoundation%2Fbeats-foundation-a9c1eafa5562186e8548b92140925552d512f52e1b9cedd337bef8544e437c15.yml

src/beats_foundation/resources/songs.py

@@ -49,7 +49,6 @@ def create(
         self,
         *,
         prompt: str,
-        creator_wallet_address: str | NotGiven = NOT_GIVEN,
         genre: str | NotGiven = NOT_GIVEN,
         is_instrumental: bool | NotGiven = NOT_GIVEN,
         lyrics: str | NotGiven = NOT_GIVEN,
@@ -67,15 +66,15 @@ def create(
         hour per API key.
 
         Args:
-          prompt: Text prompt for song generation
-
-          creator_wallet_address: Wallet address of the creator
+          prompt: Text prompt for song generation (max 200 characters)
 
           genre: Musical genre
 
-          is_instrumental: Whether the song should be instrumental
+          is_instrumental: Whether the song should be instrumental. If the song is instrumental, the lyrics
+              will be ignored.
 
-          lyrics: Optional lyrics for the song
+          lyrics: Optional lyrics for the song. If not provided, the prompt will be used to
+              generate lyrics.
 
           mood: Mood of the song
 
@@ -92,7 +91,6 @@ def create(
             body=maybe_transform(
                 {
                     "prompt": prompt,
-                    "creator_wallet_address": creator_wallet_address,
                     "genre": genre,
                     "is_instrumental": is_instrumental,
                     "lyrics": lyrics,
@@ -210,7 +208,6 @@ async def create(
         self,
         *,
         prompt: str,
-        creator_wallet_address: str | NotGiven = NOT_GIVEN,
         genre: str | NotGiven = NOT_GIVEN,
         is_instrumental: bool | NotGiven = NOT_GIVEN,
         lyrics: str | NotGiven = NOT_GIVEN,
@@ -228,15 +225,15 @@ async def create(
         hour per API key.
 
         Args:
-          prompt: Text prompt for song generation
-
-          creator_wallet_address: Wallet address of the creator
+          prompt: Text prompt for song generation (max 200 characters)
 
           genre: Musical genre
 
-          is_instrumental: Whether the song should be instrumental
+          is_instrumental: Whether the song should be instrumental. If the song is instrumental, the lyrics
+              will be ignored.
 
-          lyrics: Optional lyrics for the song
+          lyrics: Optional lyrics for the song. If not provided, the prompt will be used to
+              generate lyrics.
 
           mood: Mood of the song
 
@@ -253,7 +250,6 @@ async def create(
             body=await async_maybe_transform(
                 {
                     "prompt": prompt,
-                    "creator_wallet_address": creator_wallet_address,
                     "genre": genre,
                     "is_instrumental": is_instrumental,
                     "lyrics": lyrics,

src/beats_foundation/types/song_create_params.py

@@ -11,19 +11,22 @@
 
 class SongCreateParams(TypedDict, total=False):
     prompt: Required[str]
-    """Text prompt for song generation"""
-
-    creator_wallet_address: Annotated[str, PropertyInfo(alias="creatorWalletAddress")]
-    """Wallet address of the creator"""
+    """Text prompt for song generation (max 200 characters)"""
 
     genre: str
     """Musical genre"""
 
     is_instrumental: Annotated[bool, PropertyInfo(alias="isInstrumental")]
-    """Whether the song should be instrumental"""
+    """Whether the song should be instrumental.
+
+    If the song is instrumental, the lyrics will be ignored.
+    """
 
     lyrics: str
-    """Optional lyrics for the song"""
+    """Optional lyrics for the song.
+
+    If not provided, the prompt will be used to generate lyrics.
+    """
 
     mood: str
     """Mood of the song"""

tests/api_resources/test_songs.py

@@ -28,7 +28,6 @@ def test_method_create(self, client: Beatsfoundation) -> None:
     def test_method_create_with_all_params(self, client: Beatsfoundation) -> None:
         song = client.songs.create(
             prompt="prompt",
-            creator_wallet_address="creatorWalletAddress",
             genre="genre",
             is_instrumental=True,
             lyrics="lyrics",
@@ -146,7 +145,6 @@ async def test_method_create(self, async_client: AsyncBeatsfoundation) -> None:
     async def test_method_create_with_all_params(self, async_client: AsyncBeatsfoundation) -> None:
         song = await async_client.songs.create(
             prompt="prompt",
-            creator_wallet_address="creatorWalletAddress",
             genre="genre",
             is_instrumental=True,
             lyrics="lyrics",