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

# Ottieni dettagli del progetto

> Recupera i dettagli pubblici del progetto, la cronologia delle versioni tradotte e la cronologia della sincronizzazione labiale

# Ottieni dettagli del progetto

Recupera una vista pubblica normalizzata di un progetto. Utilizza questo endpoint quando hai bisogno della cronologia delle versioni tradotte, della cronologia della sincronizzazione labiale, dello stato dei sottotitoli dinamici o dello stato di pubblicazione.

Per un polling frequente, continua a utilizzare [Ottieni stato della traduzione](https://api-docs.voicecheap.ai/docs/it/api-reference/translation-status.md). Questo endpoint è più ricco e restituisce intenzionalmente più dati.

## Richiesta

### Intestazioni

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

La tua chiave API VoiceCheap. Ottienine una da [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Parametri del percorso

**projectId** `string` *required*

L'identificatore univoco del progetto restituito da [Crea progetto](https://api-docs.voicecheap.ai/docs/it/api-reference/create-project.md) o [Avvia traduzione](https://api-docs.voicecheap.ai/docs/it/api-reference/translate.md).

## Risposta

**projectId** `string` *required*

L'identificatore univoco del progetto.

**projectName** `string` *required*

Il nome del progetto.

**status** `string` *required*

Stato pubblico del progetto: `processing`, `success` o `failed`.

**workflow** `string` *required*

Flusso di lavoro API: `translation` o `transcription`. I flussi di lavoro di trascrizione raggiungono il successo quando la trascrizione della sorgente termina.

**originalVideoUrl** `string` *required*

URL del file video o audio originale caricato.

**originalLanguage** `string` *required*

La lingua originale rilevata o specificata.

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

Lingue di destinazione associate al progetto.

**duration** `number` *required*

Durata del contenuto in secondi.

**createdAt** `number` *required*

Timestamp Unix di quando il progetto è stato creato.

**progress** `object` *required*

Progresso attuale a livello di progetto.

**proprietà di progresso**

**progress.step** `string`

Fase attuale di creazione o trascrizione del progetto.

**progress.transcriptionProgress** `number`

Percentuale approssimativa di progresso della creazione/trascrizione del progetto.

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

Stato della trascrizione della sorgente: `processing`, `success` o `failed`.

**translations** `array` *required*

Cronologia delle versioni tradotte, ordinata con la versione più recente per prima.

**proprietà di traduzione**

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

Identificatore del lavoro di traduzione.

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

Identificatore della versione tradotta.

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

Lingua di destinazione per questa versione.

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

Stato della versione di traduzione: `in-progress`, `completed`, `not-started` o `failed`.

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

Fase attuale di doppiaggio per questa versione.

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

Percentuale approssimativa di progresso del doppiaggio.

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

Timestamp di quando questa versione tradotta è stata creata.

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

Timestamp di completamento quando disponibile.

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

Timestamp di errore quando disponibile.

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

Timestamp di timeout quando disponibile.

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

URL del video tradotto.

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

URL dell'audio tradotto.

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

Impostazioni pubbliche utilizzate per la versione tradotta, come sottotitoli, SmartSync, audio di sottofondo e modalità di qualità.

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

`translate` quando VoiceCheap ha tradotto la trascrizione con il motore di traduzione e SmartSync, `dub-only` quando il testo proviene da un `translatedSrt` fornito da te (vedi [Doppiaggio del progetto](https://api-docs.voicecheap.ai/docs/it/api-reference/dub-project.md)). Le versioni solo doppiaggio riportano sempre `smartSync: false`.

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

Codice di errore e messaggio quando la versione tradotta non è riuscita.

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

Cronologia della sincronizzazione labiale per la versione tradotta, presente solo quando è stata richiesta la sincronizzazione labiale.

**proprietà lipSync**

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

Ultimo tentativo di sincronizzazione labiale.

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

Tutti i tentativi di sincronizzazione labiale per questa versione tradotta, in ordine di creazione.

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

Identificatore del lavoro di sincronizzazione labiale.

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

Stato della sincronizzazione labiale: `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `REJECTED` o `CANCELED`.

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

URL del video con sincronizzazione labiale una volta completato.

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

Modalità di sincronizzazione labiale: `standard`, `pro` o `studio`.

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

Indica se il rilevamento del parlante attivo era abilitato per questo tentativo.

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

Stato dei sottotitoli dinamici quando disponibili.

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

Stato del tentativo di pubblicazione pubblica quando disponibile.

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

Riferimenti al video pubblicato pubblicamente quando disponibili.

## Esempio

```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
          }
        ]
      }
    }
  ]
}
```

## Errori

| Stato | Codice | Descrizione |
| - | - | - |
| 401 | `MISSING_API_KEY` | È richiesta la chiave API |
| 401 | `INVALID_API_KEY` | La chiave API fornita non è valida |
| 403 | `FORBIDDEN` | Non hai il permesso di accedere al progetto |
| 404 | `PROJECT_NOT_FOUND` | Il progetto non esiste |
| 429 | `RATE_LIMIT_EXCEEDED` | Troppe richieste |
| 500 | `INTERNAL_ERROR` | Errore imprevisto del server |


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