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

# Obtener detalles del proyecto

> Recuperar detalles públicos del proyecto, historial de versiones traducidas e historial de sincronización labial

# Obtener detalles del proyecto

Recuperar una vista pública normalizada de un proyecto. Utilice este endpoint cuando necesite el historial de versiones traducidas, el historial de sincronización labial, el estado de los subtítulos dinámicos o el estado de publicación.

Para sondeos frecuentes, siga utilizando [Obtener estado de traducción](https://api-docs.voicecheap.ai/docs/es/api-reference/translation-status.md). Este endpoint es más completo e intencionalmente devuelve más datos.

## Solicitud

### Encabezados

**x-api-key** `string` *required*

Su clave de API VoiceCheap. Obtenga una en [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Parámetros de ruta

**projectId** `string` *required*

El identificador único del proyecto devuelto desde [Crear proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/create-project.md) o [Iniciar traducción](https://api-docs.voicecheap.ai/docs/es/api-reference/translate.md).

## Respuesta

**projectId** `string` *required*

El identificador único del proyecto.

**projectName** `string` *required*

El nombre del proyecto.

**status** `string` *required*

Estado público del proyecto: `processing`, `success` o `failed`.

**workflow** `string` *required*

Flujo de trabajo de API: `translation` o `transcription`. Los flujos de trabajo de transcripción alcanzan el éxito cuando finaliza la transcripción de origen.

**originalVideoUrl** `string` *required*

URL del archivo de video o audio original cargado.

**originalLanguage** `string` *required*

El idioma original detectado o especificado.

**targetLanguages** `string[]` *required*

Idiomas de destino asociados con el proyecto.

**duration** `number` *required*

Duración del contenido en segundos.

**createdAt** `number` *required*

Marca de tiempo Unix de cuando se creó el proyecto.

**progress** `object` *required*

Progreso actual a nivel de proyecto.

**propiedades de progreso**

**progress.step** `string`

Paso actual de creación o transcripción del proyecto.

**progress.transcriptionProgress** `number`

Porcentaje aproximado de progreso de creación/transcripción del proyecto.

**progress.transcriptionStatus** `string` *required*

Estado de la transcripción de origen: `processing`, `success` o `failed`.

**translations** `array` *required*

Historial de versiones traducidas, ordenado con la versión más reciente primero.

**propiedades de traducción**

**translations\[].workId** `string`

Identificador del trabajo de traducción.

**translations\[].translatedVersionId** `string`

Identificador de la versión traducida.

**translations\[].targetLanguage** `string`

Idioma de destino para esta versión.

**translations\[].status** `string`

Estado de la versión de traducción: `in-progress`, `completed`, `not-started` o `failed`.

**translations\[].currentStep** `string`

Paso actual de doblaje para esta versión.

**translations\[].progress** `number`

Porcentaje aproximado de progreso de doblaje.

**translations\[].createdAt** `number`

Marca de tiempo de cuando se creó esta versión traducida.

**translations\[].completedAt** `number`

Marca de tiempo de finalización cuando esté disponible.

**translations\[].failedAt** `number`

Marca de tiempo de fallo cuando esté disponible.

**translations\[].timedOutAt** `number`

Marca de tiempo de tiempo de espera cuando esté disponible.

**translations\[].translatedVideoUrl** `string`

URL del video traducido.

**translations\[].translatedAudioUrl** `string`

URL del audio traducido.

**translations\[].settings** `object`

Configuraciones públicas utilizadas para la versión traducida, tales como subtítulos, SmartSync, audio de fondo y modo de calidad.

**translations\[].settings.dubbingMode** `string`

`translate` cuando VoiceCheap tradujo la transcripción con su motor de traducción y SmartSync, `dub-only` cuando el texto proviene de un `translatedSrt` que usted envió (vea [Doblar el proyecto](https://api-docs.voicecheap.ai/docs/es/api-reference/dub-project.md)). Las versiones de solo doblaje informan siempre `smartSync: false`.

**translations\[].error** `object`

Código de error y mensaje cuando la versión traducida falló.

**translations\[].lipSync** `object`

Historial de sincronización labial para la versión traducida, solo presente cuando se ha solicitado la sincronización labial.

**propiedades de lipSync**

**translations\[].lipSync.latest** `object`

Último intento de sincronización labial.

**translations\[].lipSync.history** `array`

Todos los intentos de sincronización labial para esta versión traducida, en orden de creación.

**translations\[].lipSync.history\[].jobId** `string`

Identificador del trabajo de sincronización labial.

**translations\[].lipSync.history\[].status** `string`

Estado de la sincronización labial: `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `REJECTED` o `CANCELED`.

**translations\[].lipSync.history\[].videoUrl** `string`

URL del video con sincronización labial cuando se completa.

**translations\[].lipSync.history\[].type** `string`

Modo de sincronización labial: `standard`, `pro` o `studio`.

**translations\[].lipSync.history\[].activeSpeakerDetectionEnabled** `boolean`

Si la detección de hablante activo estaba habilitada para este intento.

**translations\[].dynamicSubtitles** `object`

Estado de los subtítulos dinámicos cuando están disponibles.

**translations\[].publicationAttempts** `array`

Estado del intento de publicación pública cuando está disponible.

**translations\[].publishedVideos** `array`

Referencias de video publicado públicamente cuando están disponibles.

## Ejemplo

```bash cURL theme={null}
curl -X GET "https://api.voicecheap.ai/v1/projects/abc123-def456-ghi789" \
  -H "x-api-key: vc_your-api-key"
```

```json Response theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "Launch Demo",
  "status": "success",
  "workflow": "translation",
  "originalVideoUrl": "https://storage.example.com/input.mp4",
  "originalLanguage": "en",
  "targetLanguages": ["french"],
  "duration": 120,
  "createdAt": 1791280000000,
  "progress": {
    "step": "done",
    "transcriptionProgress": 100,
    "transcriptionStatus": "success"
  },
  "translations": [
    {
      "workId": "work_123",
      "translatedVersionId": "version_456",
      "targetLanguage": "french",
      "status": "completed",
      "currentStep": "done",
      "progress": 100,
      "createdAt": 1791280200000,
      "completedAt": 1791280800000,
      "translatedVideoUrl": "https://storage.example.com/translated.mp4",
      "translatedAudioUrl": "https://storage.example.com/translated.mp3",
      "settings": {
        "voiceCloning": true,
        "uploadType": "video",
        "keepBackgroundMusic": true,
        "keepOriginalVoice": false,
        "originalVoiceVolume": 30,
        "subtitles": {
          "isEnable": true,
          "source": "translated"
        },
        "smartSync": true,
        "dubbingMode": "translate",
        "voiceIsolatorOption": "realistic",
        "translationQualityMode": "max"
      },
      "lipSync": {
        "latest": {
          "jobId": "lip_789",
          "status": "COMPLETED",
          "videoUrl": "https://storage.example.com/lipsync.mp4",
          "errorMessage": null,
          "type": "pro",
          "createdAt": "2026-06-08T10:00:00.000Z",
          "completedAt": "2026-06-08T10:20:00.000Z",
          "activeSpeakerDetectionEnabled": true
        },
        "history": [
          {
            "jobId": "lip_789",
            "status": "COMPLETED",
            "videoUrl": "https://storage.example.com/lipsync.mp4",
            "errorMessage": null,
            "type": "pro",
            "createdAt": "2026-06-08T10:00:00.000Z",
            "completedAt": "2026-06-08T10:20:00.000Z",
            "activeSpeakerDetectionEnabled": true
          }
        ]
      }
    }
  ]
}
```

## Errores

| Estado | Código | Descripción |
| - | - | - |
| 401 | `MISSING_API_KEY` | Se requiere la clave API |
| 401 | `INVALID_API_KEY` | La clave API proporcionada no es válida |
| 403 | `FORBIDDEN` | No tiene permiso para acceder al proyecto |
| 404 | `PROJECT_NOT_FOUND` | El proyecto no existe |
| 429 | `RATE_LIMIT_EXCEEDED` | Demasiadas solicitudes |
| 500 | `INTERNAL_ERROR` | Error inesperado del servidor |


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