Skip to content
API ReferenceGetting started

Quickstart

Clone a voice, then speak with it — two calls, start to finish.

  1. 1
    Get your API key

    Open your JSF Labs dashboard and copy your secret key. It always starts with jsf_.

    Keep the key on your server. Never ship it in a browser, mobile app or public repository.

  2. 2
    Clone a voice from a sample

    Upload a clean 10–30 second recording. The response contains a permanent voiceId.

    curl -X POST https://www.jsflabs.io/api/v1/voice-clone \
      -H "x-api-key: jsf_your_api_key" \
      -F "audio=@sample.wav" \
      -F "name=Morgan" \
      -F "gender=Female" \
      -F "language=en"
  3. 3
    Speak with the cloned voice

    Pass the voiceId as voice_id together with your text.

    curl -X POST https://www.jsflabs.io/api/v1/text-to-speech \
      -H "x-api-key: jsf_your_api_key" \
      -H "Content-Type: application/json" \
      -d '{
        "text": "The quick brown fox jumps over the lazy dog.",
        "voice_id": "jsf_c3BlZWNoaWZ5X3ZvaWNlX2lk",
        "speed": 1
      }'
  4. 4
    Play or download the audio

    The response's audio_url points to a hosted WAV file — stream it directly or download it.

Next steps