> ## Documentation Index
> Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Use Typecast TTS API easily with Claude Code's AI assistant.

<Info>
  [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) is Anthropic's AI coding assistant. With **Typecast Skills**, Claude can help you integrate TTS into your projects — just ask in natural language!
</Info>

## 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:

1. **Claude Code** — Install from [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) (official installation guide)
2. **Typecast API Key** — [Get yours here](https://typecast.ai/developers/api/)

***

## Installation

Open Claude Code and run the following command:

```bash theme={null}
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.

<Tip>
  **Manual Installation**: You can also copy the skill folder directly to:

  * Personal scope: `~/.claude/skills/`
  * Project scope: `.cursor/skills/`
</Tip>

***

## Quick Start: Your First Voice Generation

Just ask Claude in natural language! Here are some example prompts:

### Basic Setup

<CodeGroup>
  ```text Get Started theme={null}
  How do I get started with Typecast TTS API?
  ```

  ```text API Key theme={null}
  How do I get a Typecast API key?
  ```

  ```text Voice List theme={null}
  Show me how to list available voices in Python.
  ```
</CodeGroup>

### Generate Code

<CodeGroup>
  ```text Python theme={null}
  Write Python code to convert "Hello world" to speech using Typecast API.
  ```

  ```text JavaScript theme={null}
  Create a JavaScript function for text-to-speech with happy emotion.
  ```

  ```text cURL theme={null}
  Give me a cURL command to generate speech with the ssfm-v30 model.
  ```
</CodeGroup>

### Troubleshoot Errors

<CodeGroup>
  ```text 403 Error theme={null}
  I'm getting a 403 error with Typecast API. What should I check?
  ```

  ```text Rate Limit theme={null}
  I got error 429 - too many requests. What are the rate limits?
  ```

  ```text Voice Not Found theme={null}
  My voice_id returns 404. How do I find valid voice IDs?
  ```
</CodeGroup>

***

## Example Conversations

### Getting Started (No Coding Experience)

<AccordionGroup>
  <Accordion title="User: I want to add voice to my app but I've never used an API before.">
    **Claude will:**

    1. Explain what an API is in simple terms
    2. Guide you through getting an API key
    3. Show the simplest possible code example
    4. Explain each line of code
  </Accordion>

  <Accordion title="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)
  </Accordion>
</AccordionGroup>

### Integrating with Your Project

<AccordionGroup>
  <Accordion title="User: I'm building a React app and need TTS. Help me integrate Typecast.">
    **Claude will:**

    1. Explain that API calls should go through a backend (security)
    2. Provide a Node.js/Express backend example
    3. Show how to call it from React
    4. Include error handling
  </Accordion>

  <Accordion title="User: Add Typecast TTS to my FastAPI server.">
    **Claude will:**

    1. Generate a complete FastAPI endpoint
    2. Use environment variables for the API key
    3. Include proper error handling
    4. Show example request/response
  </Accordion>
</AccordionGroup>

***

## 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

<CardGroup cols={2}>
  <Card title="Be Specific" icon="crosshairs">
    Instead of "help with TTS", try "generate Python code for sad emotion with ssfm-v30"
  </Card>

  <Card title="Mention Your Stack" icon="layer-group">
    Tell Claude your tech stack: "I'm using Next.js with TypeScript"
  </Card>

  <Card title="Share Errors" icon="bug">
    Paste the full error message — Claude will diagnose and fix it
  </Card>

  <Card title="Ask Follow-ups" icon="comments">
    Claude remembers context, so ask "now add error handling" or "convert to TypeScript"
  </Card>
</CardGroup>

***

## Keeping Up to Date

Update Typecast Skills to get the latest features and fixes:

```bash theme={null}
npx skills update
```

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="Code examples don't work">
    * Make sure you've replaced `YOUR_API_KEY` with your actual key
    * Check that you're using a valid `voice_id`
    * Verify your API plan supports the model you're using
  </Accordion>
</AccordionGroup>

***

## Resources

<CardGroup cols={2}>
  <Card title="Get API Key" icon="key" href="https://typecast.ai/developers/api/">
    Get your Typecast API key
  </Card>

  <Card title="Voice Library" icon="microphone" href="https://typecast.ai/developers/api/voices">
    Browse all available voices
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Explore the Typecast API
  </Card>

  <Card title="Skills Repository" icon="github" href="https://github.com/neosapience/typecast-skills">
    View source on GitHub
  </Card>
</CardGroup>