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

# Autenticação

> Autentique solicitações de API e clientes MCP com credenciais de permissões limitadas.

# Autenticação

Use uma chave de API no cabeçalho `x-api-key` ou como credencial `Authorization: Bearer`. Clientes MCP remotos também podem fazer login por OAuth. Os tokens de acesso OAuth são válidos apenas para o recurso MCP; use uma chave de API para chamadas REST.

## Criar uma chave com permissões específicas

Abra [Integrações](https://app.voicecheap.ai/page-api), crie uma chave e selecione suas permissões e uma data de expiração opcional. A chave completa é exibida apenas uma vez. Guarde-a no seu gerenciador de segredos. Você pode renomeá-la, alterar suas permissões ou expiração ou revogá-la depois.

## Permissões

Cada ação declara as permissões necessárias no [catálogo de ações](https://api-docs.voicecheap.ai/docs/pt/api-reference/actions.md). Uma ação pode exigir várias permissões. O acesso de leitura não concede permissão para criar, modificar ou excluir. As chaves existentes sem permissões explícitas mantêm apenas o acesso anterior a projetos e transcrições; edite-as ou substitua-as para habilitar novos recursos.

| Área | Leitura | Gravação ou exclusão |
| - | - | - |
| Conta | `account:read` | — |
| Uso | `usage:read` | — |
| Configurações | `settings:read` | `settings:write` |
| Equipe | `team:read` | `team:write` |
| Projetos | `projects:read` | `projects:write`, `projects:delete` |
| Tradução | — | `translations:write` |
| Transcrição | `transcription:read` | `transcription:write` |
| Legendas | `subtitles:read` | `subtitles:write` |
| Texto para fala | `tts:read` | `tts:write` |
| Vozes | `voices:read` | `voices:write` |
| Imagens | `images:read` | `images:write` |
| Miniaturas | `thumbnails:read` | `thumbnails:write` |
| Pastas | `folders:read` | `folders:write` |
| Glossário | `glossary:read` | `glossary:write` |
| Webhooks | `webhooks:read` | `webhooks:write` |
| Publicação | `publishing:read` | `publishing:write` |

As permissões restringem uma credencial; elas não alteram sua assinatura, sua função na equipe, a propriedade dos projetos nem os créditos de mídia disponíveis. As alterações administrativas da equipe continuam restritas ao proprietário da equipe.

## Exemplo de cabeçalho

Esta solicitação de descoberta lista apenas as ações permitidas pela sua chave. Não coloque uma chave de API no código do navegador nem em um repositório público.

```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"
```

## Conexões OAuth

Para assistentes compatíveis, use a [conexão MCP remota](https://api-docs.voicecheap.ai/docs/pt/ai/model-context-protocol.md) e faça login no VoiceCheap. Revise as permissões na tela de consentimento. Você pode revogar cada conexão em Integrações sem excluir suas chaves de API.

## Endpoints REST existentes

As rotas existentes de upload, tradução, projetos e transcrições continuam aceitando chaves de API e agora exigem a permissão adequada. Consulte os parâmetros na [referência da API](https://api-docs.voicecheap.ai/docs/pt/api-reference/introduction.md) e as regras de uso nos [limites](https://api-docs.voicecheap.ai/docs/pt/api-reference/limits.md).


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