> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Snabbstart för Voice Design

Den här guiden visar hur du designar en röst med en prompt via Voice Design API.

## Använda Voice Design API

> **Note**
>
> Den här guiden förutsätter att du har [konfigurerat din API-nyckel och SDK](/docs/sv/eleven-api/quickstart). Slutför
> snabbstartsguiden först om du inte redan har gjort det. För att spela upp ljud via dina högtalare kan du även behöva
> [MPV](https://mpv.io/) och/eller [ffmpeg](https://ffmpeg.org/).

#### Gör API-begäran

Att designa en röst med en prompt har två steg:

1. Generera förhandsvisningar utifrån en prompt.
2. Välj den bästa förhandsvisningen och använd den för att skapa en ny röst.

Vi börjar med att generera förhandsvisningar utifrån en prompt.

Skapa en ny fil med namnet `example.py` eller `example.mts`, beroende på vilket språk du väljer, och lägg till följande kod:

```python maxLines=0
# example.py
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import base64

load_dotenv()

elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)

voices = elevenlabs.text_to_voice.design(
    model_id="eleven_multilingual_ttv_v2",
    voice_description="A massive evil ogre speaking at a quick pace. He has a silly and resonant tone.",
    text="Your weapons are but toothpicks to me. Surrender now and I may grant you a swift end. I've toppled kingdoms and devoured armies. What hope do you have against me?",
)

for preview in voices.previews:
    # Convert base64 to audio buffer
    audio_buffer = base64.b64decode(preview.audio_base_64)

    print(f"Playing preview: {preview.generated_voice_id}")

    play(audio_buffer)
```

```typescript maxLines=0
// example.ts
import { ElevenLabsClient, play } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";
import { Readable } from 'node:stream';
import { Buffer } from 'node:buffer';

const elevenlabs = new ElevenLabsClient();

const { previews } = await elevenlabs.textToVoice.design({
    modelId: "eleven_multilingual_ttv_v2",
    voiceDescription: "A massive evil ogre speaking at a quick pace. He has a silly and resonant tone.",
    text: "Your weapons are but toothpicks to me. Surrender now and I may grant you a swift end. I've toppled kingdoms and devoured armies. What hope do you have against me?",
});

for (const preview of previews) {
    // Convert base64 to buffer and create a Readable stream
    const audioStream = Readable.from(Buffer.from(preview.audioBase64, 'base64'));

    console.log(`Playing preview: ${preview.generatedVoiceId}`);

    // Play the audio using the stream
    await play(audioStream);
}
```

#### Kör koden

```python
python example.py
```

```typescript
npx tsx example.mts
```

Du bör höra de genererade röstförhandsvisningarna spelas upp genom dina högtalare, en i taget.

#### Lägg till den genererade rösten i ditt bibliotek

När du har genererat förhandsvisningarna och valt din favorit kan du lägga till den i ditt röstbibliotek via det genererade röst-ID:t, så att den kan användas med andra API:er.

```python
voice = elevenlabs.text_to_voice.create(
    voice_name="Jolly giant",
    voice_description="A huge giant, at least as tall as a building. A deep booming voice, loud and jolly.",
    # The generated voice ID of the preview you want to use,
    # using the first in the list for this example
    generated_voice_id=voices.previews[0].generated_voice_id
)

print(voice.voice_id)
```

```typescript
const voice = await elevenlabs.textToVoice.create({
    voiceName: "Jolly giant",
    voiceDescription: "A huge giant, at least as tall as a building. A deep booming voice, loud and jolly.",
    // The generated voice ID of the preview you want to use,
    // using the first in the list for this example
    generatedVoiceId: previews[0].generatedVoiceId
});

// The ID of the newly created voice, use this to reference the voice in other APIs
console.log(voice.voiceId);
```

## Nästa steg

#### [Instant voice cloning](/docs/sv/eleven-api/guides/how-to/voices/instant-voice-cloning)

Klona en röst från befintligt ljud i stället för att generera en från en beskrivning.

#### [API-referens](/docs/sv/api-reference/text-to-voice/design)

Fullständig API-referens och parametrar för Voice Design.