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

# Referencia de la API

> Referencia completa para la API REST de VoiceCheap

# Referencia de la API

La API de VoiceCheap utiliza métodos y códigos de estado HTTP estándar. La mayoría de los endpoints devuelven JSON; las exportaciones de transcripciones también pueden devolver SRT o VTT.

Para la configuración de la cuenta, la gestión del equipo, las herramientas multimedia y otros flujos de trabajo, usa el [catálogo de acciones](https://api-docs.voicecheap.ai/docs/es/api-reference/actions.md). Estos flujos también están disponibles mediante el [servidor MCP de la cuenta](https://api-docs.voicecheap.ai/docs/es/ai/model-context-protocol.md), excepto la creación y rotación del secreto de firma de webhooks, que requieren REST. Gestiona las credenciales en [Integraciones](https://api-docs.voicecheap.ai/docs/es/ai/integrations.md) y consulta los [límites de uso](https://api-docs.voicecheap.ai/docs/es/api-reference/limits.md).

## URL base

Todas las solicitudes a la API deben realizarse a:

```text theme={null}
https://api.voicecheap.ai
```

## Autenticación

Autentica las llamadas REST privadas con una clave de API en `x-api-key` o `Authorization: Bearer`. El documento OpenAPI es público. Consulta [Autenticación](https://api-docs.voicecheap.ai/docs/es/authentication.md) para obtener información sobre las credenciales con permisos específicos y OAuth para MCP.

## API de acciones JSON

Las secciones de cuenta, equipo, proyectos, voces y herramientas multimedia documentan cada acción JSON por separado. Todas estas rutas usan `POST`, también para consultar y eliminar; envía los argumentos en el cuerpo JSON. Las rutas de subida de archivos y de proyectos existentes que aparecen abajo conservan sus propios métodos HTTP.

Crea una clave API con `account:read`, define la variable de entorno `VOICECHEAP_API_KEY` y prueba esta solicitud de solo lectura:

```bash theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/account_get' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'
```

Una acción completada devuelve HTTP 200 con el resultado en `data`. Una acción larga devuelve HTTP 202 y un `requestId`; consulta el [estado de la solicitud](https://api-docs.voicecheap.ai/docs/es/api-reference/actions/requests/action-request-get.md) para recuperar el resultado. Una tarea multimedia puede continuar después de que termine la solicitud de acción.

Consulta [todas las acciones por área](https://api-docs.voicecheap.ai/docs/es/api-reference/actions.md) o [descubre las acciones y esquemas permitidos para tu clave](https://api-docs.voicecheap.ai/docs/es/api-reference/discovery/actions-list.md). Cada página especifica permisos, parámetros, ejemplos y errores.

## Tipos de contenido

* **Solicitud**: Utilice `multipart/form-data` para cargas de archivos, `application/json` para otras solicitudes
* **Respuesta**: Los puntos finales JSON devuelven `application/json`. Las exportaciones de transcripciones también pueden devolver texto SRT o VTT.

## Subida de archivos y rutas de proyectos existentes

> [card] [Transcribir medio](https://api-docs.voicecheap.ai/docs/es/api-reference/transcribe.md)
>
> `POST /v1/transcribe`
>
> Transcriba un archivo cargado como JSON, SRT o VTT.

> [card] [Exportar transcripción del proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/project-transcript.md)
>
> `POST /v1/projects/{projectId}/transcript`
>
> Recupere transcripciones de proyectos originales o traducidas.

> [card] [Crear proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/create-project.md)
>
> `POST /v1/projects`
>
> Suba un archivo de vídeo o audio e inicie solo la transcripción.

> [card] [Iniciar traducción](https://api-docs.voicecheap.ai/docs/es/api-reference/translate.md)
>
> `POST /v1/translate`
>
> Cargue un archivo de video o audio e inicie un proyecto de traducción.

> [card] [Doblar proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/dub-project.md)
>
> `POST /v1/projects/{projectId}/dub`
>
> Doble un proyecto transcrito con su propio archivo SRT traducido.

> [card] [Obtener estado de la traducción](https://api-docs.voicecheap.ai/docs/es/api-reference/translation-status.md)
>
> `GET /v1/translate/{projectId}/status`
>
> Verifique el estado de un proyecto de traducción y recupere los resultados.

> [card] [Obtener detalles del proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/project-details.md)
>
> `GET /v1/projects/{projectId}`
>
> Recupere el historial de versiones traducidas, el historial de sincronización labial y el estado del proyecto.

> [card] [Eliminar proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/delete-project.md)
>
> `DELETE /v1/translate/{projectId}`
>
> Elimine permanentemente un proyecto de traducción y sus activos.

## Flujo de trabajo de traducción

El flujo de trabajo típico para traducir un video es:

```mermaid theme={null}
sequenceDiagram
    participant Client as Cliente
    participant API
    participant Processing as Procesamiento

    Client->>API: POST /v1/translate (archivo + opciones)
    API->>Processing: Poner en cola la traducción
    API-->>Client: 201 (projectId)

    loop Consultar el estado
        Client->>API: GET /v1/translate/{projectId}/status
        API-->>Client: status (processing/success/failed)
    end

    Note over Client: Descargar la URL del vídeo traducido cuando el estado sea "success"
```

## Formato de respuesta

Las rutas existentes de subida de archivos y proyectos que aparecen abajo mantienen sus formatos de respuesta específicos.

Los campos de una respuesta correcta dependen del endpoint. Las solicitudes para crear un proyecto o iniciar el doblaje devuelven `success`, `message` y `projectId`. Las consultas de estado y detalles devuelven el estado del proyecto; las solicitudes de transcripción devuelven JSON, SRT o VTT. Consulte la página de cada endpoint para ver su respuesta exacta.

Los errores devuelven un objeto JSON con `code` y `message`, a veces también con `details`. Consulte [Códigos de error](https://api-docs.voicecheap.ai/docs/es/api-reference/errors.md).

## Códigos de estado HTTP

| Código de estado | Descripción |
| - | - |
| 200 | Éxito |
| 201 | Creado - Se inició un proyecto o un doblaje |
| 202 | Aceptado - Sigue la acción asíncrona con su identificador de solicitud |
| 400 | Solicitud incorrecta - Parámetros no válidos |
| 401 | No autorizado - Clave de API no válida o faltante |
| 403 | Prohibido - Permisos o créditos insuficientes |
| 404 | No encontrado - El recurso no existe |
| 409 | Conflicto - El estado del proyecto no permite la solicitud |
| 413 | Carga demasiado grande - El archivo supera el límite |
| 429 | Demasiadas solicitudes - Límite de tasa excedido |
| 500 | Error interno del servidor |
| 502 | Error de procesamiento - No se pudo completar la transcripción |
| 503 | Servicio temporalmente no disponible - Conserva el identificador y consulta el estado antes de reintentar |


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