Skip to main content
Grab your API key from the dashboard (Pro or Business plan required). Export it once so you can reuse it in every command: 
export NEOSPEECH_API_KEY="sk-your-api-key"

​
1. Generate Speech

Turn text into audio and save the result as an MP3 file. 
curl https://api.neospeech.io/v1/audio/speech \
  -H "Authorization: Bearer $NEOSPEECH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Hello from NeoSpeech!",
    "voice": "lyra",
    "model": "aurora-4"
  }' \
  --output hello.mp3
You now have hello.mp3 with natural-sounding narration.

​
2. List Voices

Explore the voice library so you can pick the right tone and locale. 
curl -s "https://api.neospeech.io/v1/voices/list?gender=female&search=lyra&limit=10" \
  -H "Authorization: Bearer $NEOSPEECH_API_KEY"

{
  "success": true,
  "data": {
    "voices": [
      {
        "id": "lyra",
        "name": "Lyra",
        "gender": "Female",
        "locale": "en-US",
        "mp3_preview": "https://storage.googleapis.com/suonora-public/voices/Lyra.mp3",
        "language": "English (United States)",
        "tags": [
          "female",
          "warm",
          "professional",
          "clear",
          "versatile"
        ]
      }
    ],
    "pagination": {
      "total": 1,
      "limit": 10,
      "offset": 0,
      "has_more": false
    },
    "filters_applied": {
      "gender": "female",
      "locale": null,
      "search": "lyra"
    }
  }
}
Adjust query parameters to explore the catalogue (for example ?gender=female&search=lyra or ?locale=en-GB).

​
3. List Models

Check available audio models to balance quality and speed. 
curl -s "https://api.neospeech.io/v1/models/list" \
  -H "Authorization: Bearer $NEOSPEECH_API_KEY"
Sample response (first two models shown): 
{
  "success": true,
  "data": {
    "models": [
      {
        "name": "Aurora 4",
        "shortname": "aurora-4",
        "description": "Professional studio-quality audio with maximum clarity and depth. Perfect for high-end voiceovers, detailed narrations, and premium content creation.",
        "quality": "Premium",
        "output_format": "audio-48khz-192kbitrate-mono-mp3",
        "specifications": {
          "format": "mp3",
          "channels": "mono",
          "sample_rate": "48kHz",
          "bitrate": "192kbps"
        },
        "use_cases": [
          "professional voiceovers",
          "audiobooks",
          "premium content creation",
          "e-learning"
        ],
        "is_default": true
      },
      {
        "name": "Aurora 3.5",
        "shortname": "aurora-3.5",
        "description": "High-quality audio with balanced performance. Ideal for professional applications requiring excellent clarity and reasonable file sizes.",
        "quality": "High",
        "output_format": "audio-48khz-96kbitrate-mono-mp3",
        "specifications": {
          "format": "mp3",
          "channels": "mono",
          "sample_rate": "48kHz",
          "bitrate": "96kbps"
        },
        "use_cases": [
          "corporate videos",
          "presentations",
          "training materials",
          "podcasts"
        ],
        "is_default": false
      }
    ],
    "total": 5,
    "default_model": "aurora-4"
  }
}
Pick a model and pair it with your chosen voice in the speech request.

​
4. Check Balance

Verify credits before large jobs or scheduled runs. 
curl -s "https://api.neospeech.io/v1/balance" \
  -H "Authorization: Bearer $NEOSPEECH_API_KEY"

{
  "success": true,
  "data": {
    "balance": {
      "total_credits": 0,
      "used_credits": 11948,
      "remaining_credits": -11948,
      "overage_characters": 11948,
      "overage_amount_usd": 0.22
    },
    "plan": {
      "type": "Business",
      "next_reset": null
    },
    "usage_summary": {
      "total_characters_used": 17743,
      "current_period_usage": 11948,
      "overage_rate_per_1000": 0.018
    }
  },
  "timestamp": "2025-09-30T11:08:53.700Z"
}

​
Next