From 91fe7cb22330ab96b6cfa12f590f6c23a3b089a8 Mon Sep 17 00:00:00 2001
From: boli-bohan <bli7193@gmail.com>
Date: Thu, 20 Feb 2025 15:11:26 -0800
Subject: [PATCH] Update localization endpoint docs (#88)

---
 fern/.preview/fern-python-sdk |  2 +-
 fern/definition/voices.yml    | 40 ++++++++++++++++++++++++++++++-----
 2 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/fern/.preview/fern-python-sdk b/fern/.preview/fern-python-sdk
index 2eee2ea..03634e1 160000
--- a/fern/.preview/fern-python-sdk
+++ b/fern/.preview/fern-python-sdk
@@ -1 +1 @@
-Subproject commit 2eee2ea2074ab2d4fc8394cd19b0a6b298cb1aac
+Subproject commit 03634e1ab119899fa5278225a2277b0596c063b5
diff --git a/fern/definition/voices.yml b/fern/definition/voices.yml
index 67ed455..490de32 100644
--- a/fern/definition/voices.yml
+++ b/fern/definition/voices.yml
@@ -144,7 +144,18 @@ types:
 
   LocalizeVoiceRequest:
     properties:
-      embedding: embedding.Embedding
+      voice_id:
+        type: string
+        docs: |
+          The ID of the voice to localize.
+      name:
+        type: string
+        docs: |
+          The name of the new localized voice.
+      description:
+        type: string
+        docs: |
+          The description of the new localized voice.
       language: LocalizeTargetLanguage
       original_speaker_gender: Gender
       dialect: optional<LocalizeDialect>
@@ -301,9 +312,28 @@ service:
       path: /localize
       method: POST
       display-name: Localize Voice
+      docs: |
+        Create a new voice from an existing voice localized to a new language and dialect.
       request: LocalizeVoiceRequest
-      response: EmbeddingResponse
-
+      response: VoiceMetadata
+      examples:
+        - name: Localize Voice
+          request:
+            voice_id: "694f9389-aac1-45b6-b726-9d9369183238"
+            name: "Sarah Peninsular Spanish"
+            description: "Sarah Voice in Peninsular Spanish"
+            language: es
+            original_speaker_gender: female
+            dialect: pe
+          response:
+            body:
+              id: "8f7d3c2e-1a2b-3c4d-5e6f-7g8h9i0j1k2l"
+              user_id: "user_id"
+              is_public: false
+              name: "Sarah Peninsular Spanish"
+              description: "Sarah Voice in Peninsular Spanish"
+              created_at: "2024-03-15T10:30:00.000Z"
+              language: es
     mix:
       path: /mix
       method: POST
@@ -318,7 +348,7 @@ service:
       docs: |
         Create voice from raw features. If you'd like to clone a voice from an audio file, please use Clone Voice instead.
       request: CreateVoiceRequest
-      response: Voice
+      response: VoiceMetadata
       examples:
         - name: Create Voice
           request:
@@ -330,9 +360,9 @@ service:
           response:
             body:
               id: "8f7d3c2e-1a2b-3c4d-5e6f-7g8h9i0j1k2l"
+              user_id: "user_id"
               is_public: false
               name: "My Custom Voice"
               description: "A custom voice created through the API"
               created_at: "2024-03-15T10:30:00.000Z"
-              embedding: []
               language: en