Generate Voice Preview

curl --request POST \
  --url https://api.buena.ai/api/v2/voice-clones/preview \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "voiceId": "<string>",
  "text": "<string>"
}
'

import requests

url = "https://api.buena.ai/api/v2/voice-clones/preview"

payload = {
    "voiceId": "<string>",
    "text": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({voiceId: '<string>', text: '<string>'})
};

fetch('https://api.buena.ai/api/v2/voice-clones/preview', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.buena.ai/api/v2/voice-clones/preview",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'voiceId' => '<string>',
    'text' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.buena.ai/api/v2/voice-clones/preview"

	payload := strings.NewReader("{\n  \"voiceId\": \"<string>\",\n  \"text\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.buena.ai/api/v2/voice-clones/preview")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"voiceId\": \"<string>\",\n  \"text\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.buena.ai/api/v2/voice-clones/preview")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"voiceId\": \"<string>\",\n  \"text\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Content-Type: audio/mpeg
Content-Length: 99328
Content-Disposition: attachment; filename="preview.mp3"

POST

api

voice-clones

preview

Generate Voice Preview

curl --request POST \
  --url https://api.buena.ai/api/v2/voice-clones/preview \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "voiceId": "<string>",
  "text": "<string>"
}
'

import requests

url = "https://api.buena.ai/api/v2/voice-clones/preview"

payload = {
    "voiceId": "<string>",
    "text": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({voiceId: '<string>', text: '<string>'})
};

fetch('https://api.buena.ai/api/v2/voice-clones/preview', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.buena.ai/api/v2/voice-clones/preview",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'voiceId' => '<string>',
    'text' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.buena.ai/api/v2/voice-clones/preview"

	payload := strings.NewReader("{\n  \"voiceId\": \"<string>\",\n  \"text\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.buena.ai/api/v2/voice-clones/preview")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"voiceId\": \"<string>\",\n  \"text\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.buena.ai/api/v2/voice-clones/preview")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"voiceId\": \"<string>\",\n  \"text\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Content-Type: audio/mpeg
Content-Length: 99328
Content-Disposition: attachment; filename="preview.mp3"

Generate a preview audio sample using one of your voice clones. This allows you to test voice quality and settings before using the voice clone in LinkedIn messages or other applications.

Requires the voice:preview permission.

Request

Authorization

string

required

Bearer token with your API key that has voice:preview permission (e.g., “Bearer bna-your-api-key”)

Content-Type

string

required

Must be application/json

Body Parameters

voiceId

string

required

The ID of the voice clone to use for preview generation

text

string

required

Text to synthesize into speech (1-500 characters)

Examples

Basic Voice Preview

curl -X POST "https://api.buena.ai/api/v2/voice-clones/preview" \
  -H "Authorization: Bearer bna-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "voiceId": "pNInz6obpgDQGcFmaJgB",
    "text": "Hello! This is a test of my voice clone. How does it sound?"
  }' \
  --output preview.mp3

const response = await fetch(
  "https://api.buena.ai/api/v2/voice-clones/preview",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer bna-your-api-key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      voiceId: "pNInz6obpgDQGcFmaJgB",
      text: "Hello! This is a test of my voice clone. How does it sound?",
    }),
  }
);

// Response is audio binary data
const audioBlob = await response.blob();
const audioUrl = URL.createObjectURL(audioBlob);
const audio = new Audio(audioUrl);
audio.play();

import requests

response = requests.post(
    'https://api.buena.ai/api/v2/voice-clones/preview',
    headers={
        'Authorization': 'Bearer bna-your-api-key',
        'Content-Type': 'application/json'
    },
    json={
        'voiceId': 'pNInz6obpgDQGcFmaJgB',
        'text': 'Hello! This is a test of my voice clone. How does it sound?'
    }
)

# Save audio file
with open('preview.mp3', 'wb') as f:
    f.write(response.content)
print("Preview audio saved as preview.mp3")

Advanced Preview with Custom Settings

curl -X POST "https://api.buena.ai/api/v2/voice-clones/preview" \
  -H "Authorization: Bearer bna-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "voiceId": "pNInz6obpgDQGcFmaJgB",
    "text": "This is a test with my voice clone for maximum clarity and stability."
  }' \
  --output preview.mp3

const response = await fetch(
  "https://api.buena.ai/api/v2/voice-clones/preview",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer bna-your-api-key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      voiceId: "pNInz6obpgDQGcFmaJgB",
      text: "This is a test with my voice clone for maximum clarity and stability.",
    }),
  }
);

// Response is audio binary data
const audioBlob = await response.blob();
const audioUrl = URL.createObjectURL(audioBlob);

// Play the audio
const audio = new Audio(audioUrl);
audio.play();

Response

The response is the audio file binary data with Content-Type: audio/mpeg No JSON response is returned - the endpoint streams the audio file directly for immediate playback or download.

Content-Type: audio/mpeg
Content-Length: 99328
Content-Disposition: attachment; filename="preview.mp3"

The response body contains the binary audio data that can be played directly or saved to a file.

Preview Guidelines

Text Recommendations

Optimal Text Length

Short test: 10-30 words for quick quality check
Medium test: 50-100 words for comprehensive evaluation
Full test: 100-500 words for complete voice assessment
Avoid: Very short texts (under 5 words) may not showcase voice quality

Content Suggestions

For LinkedIn Outreach:

"Hi [Name], I hope you're having a great week! I came across your profile and was impressed by your experience in [industry]. I'd love to connect and share some insights that might be valuable for your work."

For General Testing:

"This is a test of my voice clone quality. I'm checking for naturalness, clarity, and overall sound. The voice should sound smooth and professional."

For Emotional Range:

"I'm excited to share this opportunity with you! It's been an amazing journey, and I believe this could be incredibly valuable. What do you think?"

Quality Assessment

Listen for:

Naturalness: Does it sound human and conversational?
Clarity: Are words pronounced clearly?
Consistency: Is the voice stable throughout?
Emotion: Does it convey the intended tone?
Similarity: Does it match your original voice?

Voice Settings Optimization

Setting	Low (0.0-0.3)	Medium (0.4-0.7)	High (0.8-1.0)
Stability	More expressive, variable	Balanced expression	Very consistent, robotic
Clarity	More natural, may vary	Good balance	Maximum similarity, clear
Speaker Boost	Disabled	-	Enabled

Recommended Settings by Use Case

{
  "linkedin_professional": {
    "stability": 0.6,
    "clarity": 0.8,
    "use_speaker_boost": true
  },
  "sales_energetic": {
    "stability": 0.4,
    "clarity": 0.7,
    "use_speaker_boost": true
  },
  "casual_friendly": {
    "stability": 0.5,
    "clarity": 0.6,
    "use_speaker_boost": false
  }
}

Error Responses

Voice Clone Not Found (404)

{
  "success": false,
  "error": "Voice not found or not accessible",
  "details": "The specified voice ID does not exist or you don't have access to it"
}

Text Too Long (400)

{
  "success": false,
  "error": "Text too long",
  "details": "Text exceeds maximum length of 500 characters"
}

Voice Generation Failed (500)

{
  "success": false,
  "error": "Voice generation failed",
  "details": "Failed to generate voice preview. Please try again."
}

Integration Examples

Voice Quality Testing Workflow

async function testVoiceQuality(voiceId) {
  const testTexts = [
    "Hello, this is a quick test.",
    "Hi there! I hope you're having a fantastic day. I wanted to reach out because I saw your impressive work at your company.",
    "I'm excited about this opportunity and would love to discuss it further. When might be a good time to chat?",
  ];

  const results = [];

  for (const text of testTexts) {
    try {
      const response = await fetch(
        "https://api.buena.ai/api/v2/voice-clones/preview",
        {
          method: "POST",
          headers: {
            Authorization: "Bearer bna-your-api-key",
            "Content-Type": "application/json",
          },
          body: JSON.stringify({
            voiceId: voiceId,
            text: text,
          }),
        }
      );

      const audioBlob = await response.blob();
      const audioUrl = URL.createObjectURL(audioBlob);

      results.push({
        text: text,
        audioUrl: audioUrl,
        size: audioBlob.size,
      });

      console.log(`✅ Generated preview for: "${text.substring(0, 30)}..."`);
    } catch (error) {
      console.error(`❌ Failed to generate preview: ${error.message}`);
    }
  }

  return results;
}

Next Steps

LinkedIn Voice Messages

Send voice messages via LinkedIn

Voice Clone Settings

Adjust voice generation settings

List Voice Clones

View all your voice clones

Voice Best Practices

Learn voice optimization tips

Delete Voice Clone List Leads

​Request

​Body Parameters

​Examples

​Basic Voice Preview

​Advanced Preview with Custom Settings

​Response

​Preview Guidelines

​Text Recommendations

​Voice Settings Optimization

​Recommended Settings by Use Case

​Error Responses

​Voice Clone Not Found (404)

​Text Too Long (400)

​Voice Generation Failed (500)

​Integration Examples

​Voice Quality Testing Workflow

​Next Steps

LinkedIn Voice Messages

Voice Clone Settings

List Voice Clones

Voice Best Practices

Request

Body Parameters

Examples

Basic Voice Preview

Advanced Preview with Custom Settings

Response

Preview Guidelines

Text Recommendations

Voice Settings Optimization

Recommended Settings by Use Case

Error Responses

Voice Clone Not Found (404)

Text Too Long (400)

Voice Generation Failed (500)

Integration Examples

Voice Quality Testing Workflow

Next Steps