What You Can Do
With Typecast Skills for Claude, you can:
- Get step-by-step guidance for API integration in Python, JavaScript, or cURL
- Generate working code tailored to your use case
- Troubleshoot errors with detailed explanations and solutions
- Compare pricing plans and calculate costs
- Discover voices that match your project needs
Prerequisites
Before you start, make sure you have:
- Claude Code - Install from Claude Code (official installation guide)
- Typecast API Key - Get yours here
Installation
Open Claude Code and run the following command:
npx skills add neosapience/typecast-skills
That's it! You're ready to use Typecast Skills.
Verify Installation
Ask Claude: "What can you help me with for Typecast API?"
If installed correctly, Claude will introduce itself as the Typecast TTS API expert agent.
Quick Start: Your First Voice Generation
Just ask Claude in natural language! Here are some example prompts:
Basic Setup
How do I get started with Typecast TTS API?
Generate Code
Write Python code to convert "Hello world" to speech using Typecast API.
Troubleshoot Errors
I'm getting a 403 error with Typecast API. What should I check?
Example Conversations
Getting Started (No Coding Experience)
User: I want to add voice to my app but I've never used an API before.
Claude will:
- Explain what an API is in simple terms
- Guide you through getting an API key
- Show the simplest possible code example
- Explain each line of code
User: What's the difference between ssfm-v21 and ssfm-v30?
Claude will:
- Explain that v30 is the latest model with better quality
- List the available emotions for each model
- Recommend v30 for new projects
- Explain Smart Mode (context-aware emotion)
Integrating with Your Project
User: I'm building a React app and need TTS. Help me integrate Typecast.
Claude will:
- Explain that API calls should go through a backend (security)
- Provide a Node.js/Express backend example
- Show how to call it from React
- Include error handling
User: Add Typecast TTS to my FastAPI server.
Claude will:
- Generate a complete FastAPI endpoint
- Use environment variables for the API key
- Include proper error handling
- Show example request/response
What Claude Knows About Typecast
| Topic | What Claude Can Help With |
|---|---|
| API Basics | Authentication, endpoints, request/response format |
| Code Samples | Python SDK, JavaScript SDK, Direct API, cURL |
| Voice Selection | 500+ voices, filtering by gender/age/use case |
| Emotion Control | Preset emotions, Smart Mode, intensity adjustment |
| Audio Settings | Format (WAV/MP3), volume, pitch, tempo |
| Error Handling | All error codes (400-500) with solutions |
| Pricing | Plan comparison, credit calculation |
| Best Practices | Security, environment variables, rate limits |
Tips for Best Results
Instead of "help with TTS", try "generate Python code for sad emotion with ssfm-v30"
Tell Claude your tech stack: "I'm using Next.js with TypeScript"
Paste the full error message - Claude will diagnose and fix it
Claude remembers context, so ask "now add error handling" or "convert to TypeScript"
Keeping Up to Date
Update Typecast Skills to get the latest features and fixes:
npx skills update
Troubleshooting
Claude doesn't recognize Typecast commands
- Verify the skill is properly installed in your settings
- Try restarting Claude Code
- Check that the skills repository is accessible
Claude gives outdated information
- Ask Claude to check the latest documentation
- Mention you want "ssfm-v30" specifically for the latest features
- Update your local skills repository if cloned locally
Code examples don't work
- Make sure you've replaced
YOUR_API_KEYwith your actual key - Check that you're using a valid
voice_id - Verify your API plan supports the model you're using