> 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.

# Librerie e SDK

## Librerie REST API ufficiali

ElevenLabs fornisce librerie ufficialmente supportate e aggiornate con le funzionalità più recenti disponibili nella [REST API](/docs/it/api-reference/introduction).

| Linguaggio        | GitHub                                                              | Gestore di pacchetti                                           |
| ----------------- | ------------------------------------------------------------------- | -------------------------------------------------------------- |
| Python            | [README di GitHub](https://github.com/elevenlabs/elevenlabs-python) | [PyPI](https://pypi.org/project/elevenlabs/)                   |
| JavaScript (Node) | [README di GitHub](https://github.com/elevenlabs/elevenlabs-js)     | [npm](https://www.npmjs.com/package/@elevenlabs/elevenlabs-js) |

### Invio di parametri che l'SDK non definisce ancora

Un campo può essere disponibile nell'API, ad esempio come funzionalità beta, prima che la versione del tuo SDK disponga di un parametro tipizzato per esso. Per inviarlo comunque, passalo come parametro body aggiuntivo nelle opzioni della richiesta. L'SDK unisce questi valori al body della richiesta JSON così come sono, senza convalidarli.

**`Python`**

```python title="Python"
audio = elevenlabs.text_to_speech.convert(
    voice_id="JBFqnCBsd6RMkjVDRZzb",
    text="The first move is what sets everything in motion.",
    model_id="eleven_multilingual_v2",
    request_options={"additional_body_parameters": {"new_field": "value"}},
)
```

**`TypeScript`**

```typescript title="TypeScript"
const audio = await elevenlabs.textToSpeech.convert(
  "JBFqnCBsd6RMkjVDRZzb",
  {
    text: "The first move is what sets everything in motion.",
    modelId: "eleven_multilingual_v2",
  },
  { additionalBodyParameters: { new_field: "value" } }
);
```

> **Note**
>
> Usa i nomi dei campi del riferimento API (`snake_case`). I parametri body aggiuntivi non passano dalla
> serializzazione dell'SDK, quindi i nomi delle proprietà TypeScript non vengono convertiti. In TypeScript, questa opzione
> richiede `@elevenlabs/elevenlabs-js` v2.59.0 o versioni successive e si applica solo ai body delle richieste JSON, non
> ai caricamenti di file. Passa al parametro tipizzato non appena la versione del tuo SDK lo include.

Le stesse opzioni di richiesta accettano header e parametri query aggiuntivi: `additional_headers` e `additional_query_parameters` in Python, `headers` e `queryParams` in TypeScript.

## Interfaccia a riga di comando

La [CLI di ElevenLabs](/docs/it/eleven-agents/operate/cli) porta la REST API nel tuo terminale. Homebrew (macOS) e Scoop (Windows) sono i metodi di installazione consigliati.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Lavori con un assistente di coding IA? Esegui `elevenlabs generate-skills` nel tuo progetto per creare un
> file `SKILL.md` per ogni gruppo di comandi in `skills/`, così il tuo assistente conosce tutte le funzionalità della CLI
> senza che tu debba incollare la documentazione. Usa `--output-dir` per inserirli altrove. Il comando legge la definizione API
> integrata della CLI, quindi non richiede una chiave API e funziona offline — inoltre rimane allineato
> alla versione della CLI che hai installato.

Quindi esegui l'autenticazione: si aprirà il browser per autorizzare la CLI:

```bash
elevenlabs auth login
```

## Librerie ufficiali della piattaforma Agents

Queste librerie sono progettate per l'uso con la [piattaforma Agents](/docs/it/eleven-agents/overview) di ElevenLabs.

| Linguaggio   | Documentazione                                                     | Gestore di pacchetti                                                            |
| ------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| JavaScript   | [Documentazione](/docs/it/eleven-agents/libraries/java-script)     | [npm](https://www.npmjs.com/package/@elevenlabs/client)                         |
| React        | [Documentazione](/docs/it/eleven-agents/libraries/react)           | [npm](https://www.npmjs.com/package/@elevenlabs/react)                          |
| React Native | [Documentazione](/docs/it/eleven-agents/libraries/react-native)    | [npm](https://www.npmjs.com/package/@elevenlabs/react-native)                   |
| Python       | [Documentazione](/docs/it/eleven-agents/libraries/python)          | [PyPI](https://pypi.org/project/elevenlabs/)                                    |
| Swift        | [Documentazione](/docs/it/eleven-agents/libraries/swift)           | [GitHub](https://github.com/elevenlabs/ElevenLabsSwift)                         |
| Kotlin       | [Documentazione](/docs/it/eleven-agents/libraries/kotlin)          | [Maven](https://central.sonatype.com/artifact/io.elevenlabs/elevenlabs-android) |
| Flutter      | [Documentazione](https://github.com/elevenlabs/elevenlabs-flutter) | [Pub](https://pub.dev/packages/elevenlabs_agents)                               |

## Librerie di terze parti

Queste librerie non sono ufficialmente supportate da ElevenLabs, ma sono gestite dalla community.

| Libreria      | Documentazione                                                                         | Gestore di pacchetti                                         |
| ------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| Vercel AI SDK | [Documentazione](/docs/it/eleven-api/guides/how-to/speech-to-text/batch/vercel-ai-sdk) | [npm](https://www.npmjs.com/package/ai)                      |
| .NET          | [Documentazione](https://github.com/RageAgainstThePixel/ElevenLabs-DotNet)             | [NuGet](https://www.nuget.org/packages/ElevenLabs-DotNet)    |
| Unity         | [Documentazione](https://github.com/RageAgainstThePixel/com.rest.elevenlabs)           | [OpenUPM](https://openupm.com/packages/com.rest.elevenlabs/) |