API Documentation

				POST-Example in PHP
<?php
	$postdata = http_build_query(
		array(
				'apikey' => 'YOUR-API-KEY',
				'speaker' => 'Joanna',
				'text' => 'the quick brown fox jumps over the lazy dog',
			)
		);
	$opts = array('http' =>
		array(
			'method'  => 'POST',
			'header'  => 'Content-type: application/x-www-form-urlencoded',
			'content' => $postdata
		)
	);
	$context  = stream_context_create($opts);
	$result = file_get_contents('https://api.ttsmp3.com/v1/', false, $context);
	$resultarray = json_decode($result, true);
	echo "<pre>".print_r($resultarray, true)."</pre>";

?>
<audio controls>
	<source src="<?php echo $resultarray['data']['URL']; ?>" type="audio/ogg">
</audio>
			

import requests
import json

# Your API key (replace with your actual API key)
api_key = 'YOUR-API-KEY'

# Data to be sent to the TTS API
postdata = {
	'apikey': api_key,
	'speaker': 'Joanna',
	'text': 'the quick brown fox jumps over the lazy dog',
}

# TTS API endpoint
url = 'https://api.ttsmp3.com/v1/'

# Send the POST request to the TTS API
response = requests.post(url, data=postdata)

# The API response is expected to be in JSON format
result = response.json()

# Pretty-print the result
print(json.dumps(result, indent=4))

# If there's a 'URL' in the response, we can access it as follows
if 'data' in result and 'URL' in result['data']:
	audio_url = result['data']['URL']

	# Save the audio file to the local file system
	audio_response = requests.get(audio_url)
	with open('tts_audio.mp3', 'wb') as audio_file:
		audio_file.write(audio_response.content)
	print(f"Audio file saved as 'tts_audio.mp3'.")
else:
	print("Error: Unable to retrieve the audio URL from the response.")
				

				FIRST "npm install axios"
				
const axios = require('axios');
const fs = require('fs');

// Your API key (replace with your actual API key)
const api_key = 'YOUR-API-KEY';

// Data to be sent to the TTS API
const postdata = {
    'apikey': api_key,
    'speaker': 'Joanna',
    'text': 'the quick brown fox jumps over the lazy dog',
};

// TTS API endpoint
const url = 'https://api.ttsmp3.com/v1/';

// Send the POST request to the TTS API
axios.post(url, new URLSearchParams(postdata))
    .then(response => {
        // The API response is expected to be in JSON format
        console.log(response.data);

        // If there's a 'URL' in the response, we can access it as follows
        if (response.data && response.data.data && response.data.data.URL) {
            const audioUrl = response.data.data.URL;

            // Use the streaming interface to download the file
            axios({
                method: 'get',
                url: audioUrl,
                responseType: 'stream'
            }).then(response => {
                // Create a write stream for the mp3 file
                const audioStream = fs.createWriteStream('tts_audio.mp3');
                
                // Pipe the response data to the file
                response.data.pipe(audioStream);
                
                audioStream.on('finish', () => {
                    console.log('Audio file saved as "tts_audio.mp3"');
                });
            }).catch(error => {
                console.error('Error downloading the audio file:', error);
            });

        } else {
            console.log('Error: Unable to retrieve the audio URL from the response.');
        }
    })
    .catch(error => {
        console.error('Error in API request:', error);
    });
				

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;
import java.util.StringJoiner;

public class ApiPostRequest {

    public static void main(String[] args) throws IOException, InterruptedException {
        String apiKey = "YOUR-API-KEY";
        
        HttpClient client = HttpClient.newHttpClient();
        String url = "https://api.ttsmp3.com/v1/";

        // Data to be sent to the TTS API
        Map<Object, Object> data = new HashMap<>();
        data.put("apikey", apiKey);
        data.put("speaker", "Joanna");
        data.put("text", "the quick brown fox jumps over the lazy dog");

        // Encode the data
        StringJoiner sj = new StringJoiner("&");
        for(Map.Entry<Object, Object> entry: data.entrySet()) {
            sj.add(URLEncoder.encode(entry.getKey().toString(), StandardCharsets.UTF_8) + "="
                 + URLEncoder.encode(entry.getValue().toString(), StandardCharsets.UTF_8));
        }

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Content-Type", "application/x-www-form-urlencoded")
                .POST(HttpRequest.BodyPublishers.ofString(sj.toString()))
                .build();

        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}
				

require 'net/http'
require 'uri'
require 'json'

api_key = 'YOUR-API-KEY'
url = URI.parse('https://api.ttsmp3.com/v1/')

# Data to be sent to the TTS API
params = {
  'apikey' => api_key,
  'speaker' => 'Joanna',
  'text' => 'the quick brown fox jumps over the lazy dog',
}

# Create the HTTP objects
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url.request_uri)
request.set_form_data(params)
request["Content-Type"] = "application/x-www-form-urlencoded"

# Send the request
response = http.request(request)

puts JSON.pretty_generate(JSON.parse(response.body))