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

# Autenticación

> Autentica las solicitudes de API y los clientes MCP con credenciales de permisos limitados.

# Autenticación

Usa una clave de API en el encabezado `x-api-key` o como credencial `Authorization: Bearer`. Los clientes MCP remotos también pueden iniciar sesión mediante OAuth. Los tokens de acceso OAuth solo son válidos para el recurso MCP; usa una clave de API para las llamadas REST.

## Crear una clave con permisos específicos

Abre [Integraciones](https://app.voicecheap.ai/page-api), crea una clave y selecciona sus permisos y, si lo deseas, una fecha de caducidad. La clave completa solo se muestra una vez. Guárdala en tu gestor de secretos. Más adelante puedes cambiar su nombre, sus permisos o su fecha de caducidad, o revocarla.

## Permisos

Cada acción indica los permisos que requiere en el [catálogo de acciones](https://api-docs.voicecheap.ai/docs/es/api-reference/actions.md). Una acción puede requerir varios permisos. El acceso de lectura no concede permiso para crear, modificar o eliminar. Las claves existentes sin permisos explícitos conservan únicamente el acceso a proyectos y transcripciones que tenían antes; edítalas o sustitúyelas para habilitar nuevas funciones.

| Área | Lectura | Escritura o eliminación |
| - | - | - |
| Cuenta | `account:read` | — |
| Uso | `usage:read` | — |
| Configuración | `settings:read` | `settings:write` |
| Equipo | `team:read` | `team:write` |
| Proyectos | `projects:read` | `projects:write`, `projects:delete` |
| Traducción | — | `translations:write` |
| Transcripción | `transcription:read` | `transcription:write` |
| Subtítulos | `subtitles:read` | `subtitles:write` |
| Texto a voz | `tts:read` | `tts:write` |
| Voces | `voices:read` | `voices:write` |
| Imágenes | `images:read` | `images:write` |
| Miniaturas | `thumbnails:read` | `thumbnails:write` |
| Carpetas | `folders:read` | `folders:write` |
| Glosario | `glossary:read` | `glossary:write` |
| Webhooks | `webhooks:read` | `webhooks:write` |
| Publicación | `publishing:read` | `publishing:write` |

Los permisos limitan una credencial; no cambian tu suscripción, tu rol en el equipo, la propiedad de los proyectos ni los créditos multimedia disponibles. Los cambios administrativos del equipo siguen reservados a su propietario.

## Ejemplo de encabezado

Esta solicitud de descubrimiento enumera únicamente las acciones que permite tu clave. No incluyas una clave de API en código del navegador ni en un repositorio 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"
```

## Conexiones OAuth

Con los asistentes compatibles, usa la [conexión MCP remota](https://api-docs.voicecheap.ai/docs/es/ai/model-context-protocol.md) e inicia sesión en VoiceCheap. Revisa los permisos en la pantalla de consentimiento. Puedes revocar cada conexión en Integraciones sin eliminar tus claves de API.

## Endpoints REST existentes

Las rutas existentes de subida, traducción, proyectos y transcripciones siguen aceptando claves de API y ahora exigen el permiso correspondiente. Consulta sus parámetros en la [referencia de la API](https://api-docs.voicecheap.ai/docs/es/api-reference/introduction.md) y las reglas de uso en los [límites](https://api-docs.voicecheap.ai/docs/es/api-reference/limits.md).


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