Skip to main content

​
Overview

This guide will walk you through generating your first text-to-speech audio with FineVoice. By the end, you’ll have converted text into natural-sounding speech using our API.

​
Quick Get your API Key

1. Visit the FineVoice WebsiteOpen FineVoice on your browser, and you can find the “Sign up” / “Sign in” button in the top right corner.2. Choose a Sign up or Sign in Method
  • **Method 1: Register/Login with a Google Account ** Click “Sign up” or “Sign in” and choose “Continue with Google”. Then, select your Google account. If you are not logged in, enter your password, click “Continue”, and you will successfully log in to FineVoice.
  • Method 2: Register/Login with an Apple Accoun On the “Sign up” or “Sign in” page, click “Continue with Apple”. Enter your email address or phone number and click “Continue”. Then, enter your password and click “Sign In”.
  • Method 3: Register/Login with Email On the “Sign up” or “Sign in” page, click “Continue with Email”. Then, enter your email address and password and click “Sign up” or “Sign in”. You will receive a verification email in your mailbox. Find the mail and click the verification link to complete registration.
3. Log in to your account and navigate to the usercenter
  1.  Go to https://finevoice.fineshare.com/usercenter
  2.  Navigate to the API Tokens
  3. Generate Secret Key
Keep your API key secret! Never commit it to version control or share it publicly.

​
Your First TTS Request

Let’s create your first audio file from text.

Set your API key

Store your API key as an environment variable (recommended approach):
export FINEVOICE_API_KEY="replace_me"

Make the TTS request

The following example uses the default voice. To use a different voice, change the voice parameter and provide the model name from FineVoice. You can retrieve detailed information about available voices using the methods below. [View Voice API]
Run this cURL command to generate your first voice:
curl -X POST https://converter.fineshare.com/api/fsmstexttospeech \
  -H "Authorization: Bearer $FINEVOICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "Engine": "v7",
  "AppId": "107",
  "FeatureId": "22",
  "speech": "[happy] Hi, welcome to today’s video! In this episode, [breathe] I’ll show you some practical voice generation tips that can make your audio projects a lot easier and more creative. [clear_throat] Stick around, and let’s jump right in!",
  "voice": "james",
  "platform": "web",
  "Parameter": {
    "Speed": 1.0,
    "LanguageCode": "en-US",
    "Pitch": 0.0
  }
}'\
Windows Command Prompt:
curl -X POST https://converter.fineshare.com/api/fsmstexttospeech -H "Authorization: Bearer %FINEVOICE_API_KEY%" -H "Content-Type: application/json" -d "{\"Engine\":\"v7\",\"AppId\":\"107\",\"FeatureId\":\"22\",\"speech\":\"[happy] Hi, welcome to today’s video! In this episode, [breathe] I’ll show you some practical voice generation tips that can make your audio projects a lot easier and more creative. [clear_throat] Stick around, and let’s jump right in!\",\"voice\":\"james\",\"platform\":\"web\",\"Parameter\":{\"Speed\":1.0,\"LanguageCode\":\"en-US\",\"Pitch\":0.0}}"

Get the Audio Download URL

The response returns a unique uuid that identifies the generated audio task.
Use this uuid in the subsequent request to retrieve the audio download URL.
{
  "uuid": "6d2fec0a-0983-4b3f-b3f8-6038d12187ce",
  "available_count": 298825,
  "wordBoundaries": [],
  "error": {
    "code": "0001",
    "message": null
  }
}
Use the following request to check the file generation status and retrieve the audio download URL:
curl -X GET https://voiceai.fineshare.com/api/checkfilechangestatus/{uuid}
Replace {uuid} with the uuid returned from the text-to-speech request.
When the audio file is ready, the response will include the audio download URL.Response Example:
{
    "uuid": "6d2fec0a-0983-4b3f-b3f8-6038d12187ce",
    "client": null,
    "status": 3,
    "url": "https://dlaudio.fineshare.net/ovc/6d2fec0a-0983-4b3f-b3f8-6038d12187ce.mp3",
    "coverUrl": null,
    "duration": 16,
    "title": "welcome to today’s video",
    "error": {
        "code": "0001",
        "message": null
    }
}
4

Download the Audio File

Run the following cURL command to download the audio file:
curl -L -o output.mp3 https://dlaudio.fineshare.net/ovc/6d2fec0a-0983-4b3f-b3f8-6038d12187ce.mp3
5

Play the Downloaded Audio

The audio has been saved as output.mp3. You can play it by:
  • Double-clicking the file or opening it in any media player
  • Or using the command line: 
    # On macOS
afplay output.mp3

# On Linux
mpg123 output.mp3

# On Windows
start output.mp3

​
List AI Voices

Explore all AI voices you can use for text-to-speech generation.
1

Set your API key

Store your API key as an environment variable (recommended approach):
export FINEVOICE_API_KEY="replace_me"
2

List Available Voice Models

Retrieve a paginated list of available AI voice models with filters for gender, language, page number, and page size. This API helps you browse and select voices for text-to-speech or voice conversion tasks. Check out the API reference here.
curl -X GET "https://converter.fineshare.com/api/pagevoices?v=v2&gender=all&language=en-US&page=1&limit=10" \
  -H "Authorization: Bearer $FINEVOICE_API_KEY" \
  -o "pagevoices.json"

​
Support

Need help? Check out these resources: