Merge branch 'feat/voice-fr-ca-fr-fr' into 'main'

Add Voice API French variants fr-FR (GA) and fr-CA (beta) as translation targets

See merge request deepl-org/deepl/clapi-track/api-docs-mirror!251

Author: Patrick Schlarmann

api-reference/openapi.json

@@ -10070,6 +10070,8 @@
             "et",
             "fi",
             "fr",
+            "fr-CA",
+            "fr-FR",
             "ga",
             "he",
             "hi",
@@ -10131,6 +10133,8 @@
             "es",
             "fi",
             "fr",
+            "fr-CA",
+            "fr-FR",
             "hi",
             "hr",
             "hu",

api-reference/openapi.yaml

@@ -7466,6 +7466,8 @@ components:
           - et
           - fi
           - fr
+          - fr-CA
+          - fr-FR
           - ga
           - he
           - hi
@@ -7529,6 +7531,8 @@ components:
           - es
           - fi
           - fr
+          - fr-CA
+          - fr-FR
           - hi
           - hr
           - hu

api-reference/voice/deepl-voice-api-service-specification-updates.mdx

@@ -99,6 +99,8 @@ audio provides the following functionality:
                 <li>`et` (Estonian)</li>
                 <li>`fi` (Finnish)</li>
                 <li>`fr` (French)</li>
+                <li>`fr-CA` (French (Canadian))</li>
+                <li>`fr-FR` (French)</li>
                 <li>`ga` (Irish)</li>
                 <li>`he` (Hebrew)</li>
                 <li>`hi` (Hindi)</li>

docs/resources/roadmap-and-release-notes.mdx

@@ -10,6 +10,11 @@ rss: true
 </Update>
 
 <Update label="September 2026">
+## September 8 - Voice API French Variants: French (France) and French (Canadian)
+- The Voice API now supports `fr-FR` (French, France) and `fr-CA` (French, Canadian) as target language variants for translation and translated speech (translated speech for both variants is in beta and uses the French voices). `fr-FR` is generally available; `fr-CA` is in beta for the Voice API (for text and document translation it has been generally available since July 17).
+- Because `fr-CA` is beta, include `include=beta` when calling [`GET /v3/languages?resource=voice`](/docs/languages/using-the-languages-api) to see it.
+- See the [supported languages table](/docs/voice/supported-voice-languages) for the full Voice API language list.
+
 ## September 1 - Croatian and Tagalog Translated Speech in the Voice API
 - The [Voice API](/docs/voice/overview) now generates translated speech (voice output) for `hr` (Croatian) and `tl` (Tagalog), in beta. Transcription and translation for these languages were already supported; this adds synthesized audio.
 - Translated speech for both languages is provided by external service partners. In the [`GET /v3/languages?resource=voice`](/docs/languages/using-the-languages-api) response, `translated_speech` is reported with `"external": true` and beta status — call with `include=beta&include=external` to see it.

docs/voice/supported-voice-languages.mdx

@@ -20,7 +20,7 @@ Translation is always provided by DeepL. For some languages, transcription and t
 | English (American/British) | ✓ | ✓ | ✓ |
 | Estonian | ⎋ | ✓ | — |
 | Finnish | ⎋ | ✓ | ⎋ |
-| French | ✓ | ✓ | ✓ |
+| French (France/Canada <Badge color="blue">beta</Badge>) | ✓ | ✓ | ✓ |
 | German | ✓ | ✓ | ✓ |
 | Greek | ⎋ | ✓ | ⎋ |
 | Hebrew | ⎋ | ✓ | — |
@@ -53,6 +53,8 @@ Translation is always provided by DeepL. For some languages, transcription and t
 {/* END GENERATED voice-language-matrix */}
 
 ✓ provided by DeepL / ⎋ provided by an external service partner / — not available
+
+Parenthesized regional variants (e.g. `en-US`, `pt-BR`, `fr-CA`) are additional target-language options (translation, and translated speech where the base language has it); the other columns describe the base language. A beta badge inside the parentheses applies to that variant only — `fr-CA` is beta as a translation target.
 </Card>
 
 <Warning>

scripts/generate-voice-languages.mjs

@@ -11,6 +11,7 @@ import { byCode, byName, fetchLanguages, parseArgs, replaceBlock } from './lib.m
 // The matrix folds target-only variants into their base language's row.
 const MATRIX_NAME_OVERRIDES = {
   en: 'English (American/British)',
+  fr: 'French (France/Canada <Badge color="blue">beta</Badge>)',
   pt: 'Portuguese (Brazil/Portugal)',
   zh: 'Chinese (Simplified/Traditional)',
 };