@fias/create-fias-plugin 1.16.0 → 1.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- fias-sdk-guide-version: 2.
|
|
1
|
+
<!-- fias-sdk-guide-version: 2.25.0 -->
|
|
2
2
|
|
|
3
3
|
# FIAS Plugin Development Guide
|
|
4
4
|
|
|
@@ -776,7 +776,11 @@ const { translation, detectedSourceLang } = await invoke<TranslateParams, Transl
|
|
|
776
776
|
|
|
777
777
|
Specialty capabilities expose **typed convenience hooks** generated from the platform's surface registry. Each hook bakes in a `surfaceKey` and infers params/result types from the surface's schemas.
|
|
778
778
|
|
|
779
|
-
Currently shipped audio hooks: `useLyriaMusic`, `useElevenLabsTts`, `useElevenLabsMusic`, `useElevenLabsSfx`, `useElevenLabsStt`, `useElevenLabsAudioIsolation`, `useElevenLabsForcedAlignment`, `useElevenLabsVoiceChanger`, `useElevenLabsVoiceDesign`. Browse the full surface list with `npx fias-dev entities`.
|
|
779
|
+
Currently shipped audio hooks: `useLyriaMusic`, `useElevenLabsTts`, `useElevenLabsMusic`, `useElevenLabsSfx`, `useElevenLabsStt`, `useElevenLabsAudioIsolation`, `useElevenLabsForcedAlignment`, `useElevenLabsVoiceChanger`, `useElevenLabsVoiceDesign`, `useGeminiTts`, `useGeminiTranscribe`. Browse the full surface list with `npx fias-dev entities`.
|
|
780
|
+
|
|
781
|
+
**Gemini speech.** `useGeminiTts` speaks `text` in one of 30 named voices (`voiceName`, default `'Kore'`); an optional `style` (e.g. `'cheerful and friendly'`) shapes the delivery and is not spoken. It runs Gemini 3.8 Flash TTS; pass `entityId: 'ent_intg_gemini_tts_flash_lite00'` for the lower-cost Flash-Lite. The result is a saved 24 kHz WAV (`audioUrl`, `audioRef`, `fileId`, `durationSeconds`). `useGeminiTranscribe` takes audio the same way as `useElevenLabsStt` (`fileId` or a prior `audioRef`) and returns the transcript `text`.
|
|
782
|
+
|
|
783
|
+
**Lyria 3.5.** `useLyriaMusic` runs Lyria 2 (30 s instrumental clips) unless you pass `entityId: 'ent_modeldef_lyria35'`, which makes full songs — vocals or instrumental, one MP3 each, at a length the model chooses (steer it from the prompt with section tags such as `[Verse]` and `[Chorus]`). Each song takes about 20–60 s and is billed per song. `negativePrompt`, `seed` and `durationSeconds` apply to Lyria 2 only. `result.provider` is `'google-vertex'` (Lyria 2) or `'google-gemini'` (Lyria 3.5) — an exhaustive switch on it needs both cases.
|
|
780
784
|
|
|
781
785
|
A legacy `useAudioGeneration()` hook still ships for back-compat with code written before the typed-surface migration. New plugins should use the typed hooks above — the legacy hook will be removed in a future major version.
|
|
782
786
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- fias-sdk-guide-version: 2.
|
|
1
|
+
<!-- fias-sdk-guide-version: 2.25.0 -->
|
|
2
2
|
|
|
3
3
|
# FIAS Plugin Development Guide
|
|
4
4
|
|
|
@@ -776,7 +776,11 @@ const { translation, detectedSourceLang } = await invoke<TranslateParams, Transl
|
|
|
776
776
|
|
|
777
777
|
Specialty capabilities expose **typed convenience hooks** generated from the platform's surface registry. Each hook bakes in a `surfaceKey` and infers params/result types from the surface's schemas.
|
|
778
778
|
|
|
779
|
-
Currently shipped audio hooks: `useLyriaMusic`, `useElevenLabsTts`, `useElevenLabsMusic`, `useElevenLabsSfx`, `useElevenLabsStt`, `useElevenLabsAudioIsolation`, `useElevenLabsForcedAlignment`, `useElevenLabsVoiceChanger`, `useElevenLabsVoiceDesign`. Browse the full surface list with `npx fias-dev entities`.
|
|
779
|
+
Currently shipped audio hooks: `useLyriaMusic`, `useElevenLabsTts`, `useElevenLabsMusic`, `useElevenLabsSfx`, `useElevenLabsStt`, `useElevenLabsAudioIsolation`, `useElevenLabsForcedAlignment`, `useElevenLabsVoiceChanger`, `useElevenLabsVoiceDesign`, `useGeminiTts`, `useGeminiTranscribe`. Browse the full surface list with `npx fias-dev entities`.
|
|
780
|
+
|
|
781
|
+
**Gemini speech.** `useGeminiTts` speaks `text` in one of 30 named voices (`voiceName`, default `'Kore'`); an optional `style` (e.g. `'cheerful and friendly'`) shapes the delivery and is not spoken. It runs Gemini 3.8 Flash TTS; pass `entityId: 'ent_intg_gemini_tts_flash_lite00'` for the lower-cost Flash-Lite. The result is a saved 24 kHz WAV (`audioUrl`, `audioRef`, `fileId`, `durationSeconds`). `useGeminiTranscribe` takes audio the same way as `useElevenLabsStt` (`fileId` or a prior `audioRef`) and returns the transcript `text`.
|
|
782
|
+
|
|
783
|
+
**Lyria 3.5.** `useLyriaMusic` runs Lyria 2 (30 s instrumental clips) unless you pass `entityId: 'ent_modeldef_lyria35'`, which makes full songs — vocals or instrumental, one MP3 each, at a length the model chooses (steer it from the prompt with section tags such as `[Verse]` and `[Chorus]`). Each song takes about 20–60 s and is billed per song. `negativePrompt`, `seed` and `durationSeconds` apply to Lyria 2 only. `result.provider` is `'google-vertex'` (Lyria 2) or `'google-gemini'` (Lyria 3.5) — an exhaustive switch on it needs both cases.
|
|
780
784
|
|
|
781
785
|
A legacy `useAudioGeneration()` hook still ships for back-compat with code written before the typed-surface migration. New plugins should use the typed hooks above — the legacy hook will be removed in a future major version.
|
|
782
786
|
|