mai-voice

Generates speech from text and transcribes audio via the MAI Voice API on Pixazo.

Updated May 2, 2026
One-click install
npx skills add https://github.com/Pixazo-AI/skills --skill mai-voice-pixazo-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mai-voice
Source: https://github.com/Pixazo-AI/skills/tree/main/skills/mai-voice
Command: npx skills add https://github.com/Pixazo-AI/skills --skill mai-voice-pixazo-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Converting text into natural-sounding speech or transcribing audio normally requires setting up Azure Speech credentials and learning SSML configuration. This Skill lets an AI agent call Microsoft's MAI Voice models through the Pixazo API gateway with a single stored API key, handling authentication, request formatting, and error recovery automatically. ## Core Features & Use Cases - Text-to-Speech Synthesis: Generate expressive speech with MAI-Voice-2 across 47 voices and 18 locales, with SSML emotion control via style and styledegree parameters. - Speech-to-Text Transcription: Transcribe audio across 43 languages using MAI-Transcribe-1.5 through the same gateway. - Managed Authentication: Detects the Pixazo API key from environment variables or a saved file, prompting the user only once and storing it securely. - Use Case: A content creator asks the agent to read a blog post aloud in an excited tone; the agent calls the text-to-speech endpoint and returns a playable audio URL. ## Quick Start Ask the agent to convert the text "Hello from Pixazo" into speech using MAI Voice 2 with an excited style.

Frequently Asked Questions about mai-voice

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert text to speech with MAI Voice API?▼

Send a POST request to https://gateway.pixazo.ai/mai-voice-2/v1/text-to-speech with your Pixazo API key in the Ocp-Apim-Subscription-Key header and a JSON body containing text, voice, and optional style fields. The response returns a JSON object with an audio URL.

What voices and languages does MAI Voice 2 support?▼

MAI Voice 2 supports 47 voices across 18 locales, such as en-US-Harper:MAI-Voice-2. It also offers SSML emotion control through style and styledegree parameters for expressive speech output.

Can MAI Voice transcribe audio to text?▼

Yes, MAI-Transcribe-1.5 handles speech-to-text across 43 languages via the endpoint https://gateway.pixazo.ai/mai-transcribe/v1/speech-to-text. It uses the same Pixazo API key authentication as the text-to-speech operation.

Where do I get a Pixazo API key for text-to-speech?▼

Get a free key at https://api-console.pixazo.ai/api_keys by signing in and clicking Create new key. The Skill saves it to ~/.pixazo/api-key so you only provide it once.

Why does the MAI Voice API return a 401 or 429 error?▼

A 401 means the API key is missing or invalid, so generate a fresh one at the Pixazo console. A 429 indicates rate limiting; wait about 5 seconds and retry the request once.