> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticazione

> Autentica le richieste API e i client MCP con credenziali dalle autorizzazioni limitate.

# Autenticazione

Usa una chiave API nell'header `x-api-key` o come credenziale `Authorization: Bearer`. I client MCP remoti possono anche accedere tramite OAuth. I token di accesso OAuth sono validi solo per la risorsa MCP; per le chiamate REST usa una chiave API.

## Crea una chiave con autorizzazioni specifiche

Apri [Integrazioni](https://app.voicecheap.ai/page-api), crea una chiave e selezionane le autorizzazioni e l'eventuale scadenza. La chiave completa viene mostrata una sola volta. Conservala nel tuo gestore di segreti. In seguito puoi rinominarla, modificarne le autorizzazioni o la scadenza, oppure revocarla.

## Autorizzazioni

Ogni azione dichiara le autorizzazioni richieste nel [catalogo delle azioni](https://api-docs.voicecheap.ai/docs/it/api-reference/actions.md). Un'azione può richiedere più autorizzazioni. L'accesso in lettura non autorizza a creare, modificare o eliminare. Le chiavi esistenti senza autorizzazioni esplicite mantengono solo il precedente accesso a progetti e trascrizioni; modificale o sostituiscile per abilitare nuove funzionalità.

| Area | Lettura | Scrittura o eliminazione |
| - | - | - |
| Account | `account:read` | — |
| Utilizzo | `usage:read` | — |
| Impostazioni | `settings:read` | `settings:write` |
| Team | `team:read` | `team:write` |
| Progetti | `projects:read` | `projects:write`, `projects:delete` |
| Traduzione | — | `translations:write` |
| Trascrizione | `transcription:read` | `transcription:write` |
| Sottotitoli | `subtitles:read` | `subtitles:write` |
| Sintesi vocale | `tts:read` | `tts:write` |
| Voci | `voices:read` | `voices:write` |
| Immagini | `images:read` | `images:write` |
| Miniature | `thumbnails:read` | `thumbnails:write` |
| Cartelle | `folders:read` | `folders:write` |
| Glossario | `glossary:read` | `glossary:write` |
| Webhook | `webhooks:read` | `webhooks:write` |
| Pubblicazione | `publishing:read` | `publishing:write` |

Le autorizzazioni limitano una credenziale; non modificano l'abbonamento, il ruolo nel team, la proprietà dei progetti o i crediti multimediali disponibili. Le modifiche amministrative al team restano riservate al proprietario del team.

## Esempio di header

Questa richiesta di discovery elenca solo le azioni consentite dalla tua chiave. Non inserire una chiave API nel codice del browser o in un repository pubblico.

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "x-api-key: vc_your-api-key"
```

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "Authorization: Bearer vc_your-api-key"
```

## Connessioni OAuth

Con gli assistenti compatibili, usa la [connessione MCP remota](https://api-docs.voicecheap.ai/docs/it/ai/model-context-protocol.md) e accedi a VoiceCheap. Esamina le autorizzazioni nella schermata di consenso. Puoi revocare ogni connessione in Integrazioni senza eliminare le chiavi API.

## Endpoint REST esistenti

Le route esistenti per caricamenti, traduzioni, progetti e trascrizioni continuano ad accettare chiavi API e ora richiedono l'autorizzazione appropriata. Consulta i parametri nella [documentazione di riferimento dell'API](https://api-docs.voicecheap.ai/docs/it/api-reference/introduction.md) e le regole di utilizzo nei [limiti](https://api-docs.voicecheap.ai/docs/it/api-reference/limits.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.