mirror of
https://github.com/mastra-ai/mastra.git
synced 2026-11-17 08:44:46 +00:00
|
History
|
||
|---|---|---|
| .. | ||
| __fixtures__ | ||
| src | ||
| test-outputs | ||
| CHANGELOG.md | ||
| lint-staged.config.js | ||
| package.json | ||
| README.md | ||
| tsconfig.build.json | ||
| tsconfig.json | ||
| tsdown.config.ts | ||
| vitest.config.ts | ||
@mastra/voice-openai
Add OpenAI text-to-speech and speech-to-text to Mastra with configurable models, voices, audio formats, synthesis, and transcription.
Installation
npm install @mastra/voice-openai
Usage
import { OpenAIVoice } from '@mastra/voice-openai';
// Create voice with both speech and listening capabilities
const voice = new OpenAIVoice({
speechModel: {
name: 'tts-1', // or 'tts-1-hd' for higher quality
apiKey: 'your-api-key', // Optional, can use OPENAI_API_KEY env var
},
listeningModel: {
name: 'whisper-1',
apiKey: 'your-api-key', // Optional, can use OPENAI_API_KEY env var
},
speaker: 'alloy', // Default voice
});
// Or create speech-only voice
const speechVoice = new OpenAIVoice({
speechModel: {
name: 'tts-1',
apiKey: 'your-api-key',
},
speaker: 'nova',
});
// Or create listening-only voice
const listeningVoice = new OpenAIVoice({
listeningModel: {
name: 'whisper-1',
apiKey: 'your-api-key',
},
});
// List available voices
const speakers = await voice.getSpeakers();
// Generate speech
const audioStream = await voice.speak('Hello from Mastra!', {
speaker: 'nova', // Optional: override default speaker
speed: 1.0, // Optional: adjust speech speed
});
// Convert speech to text
const text = await voice.listen(audioStream, {
filetype: 'wav',
});
Documentation
Changelog
See the package changelog for version history and release notes.
Support
We have an open community Discord. Come and say hello and let us know if you have any questions or need any help getting things running.