Autenticación

La API de VoiceCheap utiliza claves de API para la autenticación. Todas las solicitudes a la API deben incluir su clave de API en el encabezado x-api-key.

Obtención de su clave de API

Inicie sesión en VoiceCheap

Vaya a app.voicecheap.ai e inicie sesión en su cuenta.

Navegue a la página de API

Vaya a la página de API en app.voicecheap.ai/page-api.

Generar clave de API

Haga clic en Crear nueva clave y asígnele un nombre. Su clave de API completa se mostrará solo una vez; cópiela y guárdela de forma segura inmediatamente.

Importante: Guarde su clave inmediatamenteSu clave de API completa se muestra solo una vez al crearla. Después de cerrar el modal, solo verá una versión enmascarada (vc_abc...xyz). Si pierde su clave, deberá eliminarla y crear una nueva.

Límites de la clave de API

Puede crear un máximo de 5 claves de API por cuenta
Cada clave puede tener un nombre para facilitar su identificación (por ejemplo, “Producción”, “Desarrollo”)
Las claves se pueden eliminar en cualquier momento desde la página de API

Uso de su clave de API

Incluya su clave de API en el encabezado x-api-key con cada solicitud:

curl -X POST https://api.voicecheap.ai/v1/translate \
  -H "x-api-key: vc_your-api-key-here" \
  -F "file=@video.mp4" \
  -F "targetLanguage=spanish"

const formData = new FormData();
formData.append('file', videoFile);
formData.append('targetLanguage', 'spanish');

const response = await fetch('https://api.voicecheap.ai/v1/translate', {
  method: 'POST',
  headers: {
    'x-api-key': 'vc_your-api-key-here'
  },
  body: formData
});

const data = await response.json();

const formData = new FormData();
formData.append('file', videoFile);
formData.append('targetLanguage', 'spanish');

const response = await fetch('https://api.voicecheap.ai/v1/translate', {
  method: 'POST',
  headers: {
    'x-api-key': 'vc_your-api-key-here'
  },
  body: formData
});

const data = await response.json();

import requests

files = {'file': open('video.mp4', 'rb')}
data = {'targetLanguage': 'spanish'}
headers = {'x-api-key': 'vc_your-api-key-here'}

response = requests.post(
    'https://api.voicecheap.ai/v1/translate',
    headers=headers,
    files=files,
    data=data
)

Requisitos

Se requiere suscripción de pagoEl acceso a la API requiere una suscripción de pago activa. Las cuentas gratuitas no pueden utilizar la API. Si intenta utilizar la API sin una suscripción válida, recibirá un error 403 Forbidden.

Seguridad de la clave de API

Manténgala en secreto

Nunca exponga su clave de API en código del lado del cliente, repositorios públicos o cualquier ubicación accesible públicamente.

Utilice variables de entorno

Almacene su clave de API en variables de entorno o en un gestor de secretos seguro.

Rótela regularmente

Rote periódicamente sus claves de API, especialmente si sospecha que pueden haber sido comprometidas.

Supervise el uso

Realice un seguimiento del uso de su API para detectar cualquier acceso no autorizado.

Respuestas de error

Si la autenticación falla, recibirá uno de los siguientes errores:

Código de estado	Código de error	Descripción
401	`MISSING_API_KEY`	No se proporcionó el encabezado `x-api-key`
401	`INVALID_API_KEY_FORMAT`	La clave de API no utiliza el prefijo `vc_` esperado
401	`INVALID_API_KEY`	La clave de API proporcionada no es válida
403	`API_ACCESS_REQUIRED`	El acceso a la API no está habilitado para esta cuenta
403	`SUBSCRIPTION_REQUIRED`	El acceso a la API requiere una suscripción de pago activa
403	`INSUFFICIENT_CREDITS`	Su cuenta no tiene suficientes créditos para esta operación

Ejemplo de respuesta de error

{
  "code": "INVALID_API_KEY",
  "message": "The provided API key is invalid. Please check your API key and try again."
}

Descripción general

Transcripción

Traducción

Referencia

Autenticación

Autenticación

Obtención de su clave de API

Límites de la clave de API

Uso de su clave de API

Requisitos

Seguridad de la clave de API

Manténgala en secreto

Utilice variables de entorno

Rótela regularmente

Supervise el uso

Respuestas de error

Ejemplo de respuesta de error

​Autenticación

​Obtención de su clave de API

​Límites de la clave de API

​Uso de su clave de API

​Requisitos

​Seguridad de la clave de API

Manténgala en secreto

Utilice variables de entorno

Rótela regularmente

Supervise el uso

​Respuestas de error

​Ejemplo de respuesta de error

Autenticación

Obtención de su clave de API

Límites de la clave de API

Uso de su clave de API

Requisitos

Seguridad de la clave de API

Respuestas de error

Ejemplo de respuesta de error