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

# Projectdetails ophalen

> Haal openbare projectdetails, vertaalde versiegeschiedenis en lipsynchronisatiegeschiedenis op

# Projectdetails ophalen

Haal een genormaliseerde openbare weergave van een project op. Gebruik dit eindpunt wanneer u vertaalde versiegeschiedenis, lipsynchronisatiegeschiedenis, de status van dynamische ondertitels of de publicatiestatus nodig heeft.

Blijf voor frequente polling [Vertaalstatus ophalen](https://api-docs.voicecheap.ai/docs/nl/api-reference/translation-status.md) gebruiken. Dit eindpunt is rijker en retourneert opzettelijk meer gegevens.

## Verzoek

### Headers

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

Uw VoiceCheap API-sleutel. Haal er een op via [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Padparameters

**projectId** `string` *required*

De unieke identificatiecode van het project geretourneerd door [Project aanmaken](https://api-docs.voicecheap.ai/docs/nl/api-reference/create-project.md) of [Vertaling starten](https://api-docs.voicecheap.ai/docs/nl/api-reference/translate.md).

## Antwoord

**projectId** `string` *required*

De unieke identificatiecode van het project.

**projectName** `string` *required*

De projectnaam.

**status** `string` *required*

Openbare projectstatus: `processing`, `success` of `failed`.

**workflow** `string` *required*

API-workflow: `translation` of `transcription`. Transcriptieworkflows bereiken succes wanneer de brontranscriptie is voltooid.

**originalVideoUrl** `string` *required*

URL naar het oorspronkelijk geüploade video- of audiobestand.

**originalLanguage** `string` *required*

De gedetecteerde of opgegeven brontaal.

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

Doeltalen gekoppeld aan het project.

**duration** `number` *required*

Duur van de inhoud in seconden.

**createdAt** `number` *required*

Unix-tijdstempel waarop het project is aangemaakt.

**progress** `object` *required*

Huidige voortgang op projectniveau.

**voortgangseigenschappen**

**progress.step** `string`

Huidige stap voor het aanmaken of transcriberen van het project.

**progress.transcriptionProgress** `number`

Geschat voortgangspercentage van het aanmaken/transcriberen van het project.

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

Status van brontranscriptie: `processing`, `success` of `failed`.

**translations** `array` *required*

Vertaalde versiegeschiedenis, gesorteerd met de nieuwste versie eerst.

**vertaaleigenschappen**

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

Identificatiecode voor vertaalwerk.

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

Identificatiecode voor vertaalde versie.

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

Doeltaal voor deze versie.

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

Status van vertaalversie: `in-progress`, `completed`, `not-started` of `failed`.

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

Huidige stap voor nasynchronisatie voor deze versie.

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

Geschat voortgangspercentage van nasynchronisatie.

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

Tijdstempel waarop deze vertaalde versie is aangemaakt.

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

Tijdstempel van voltooiing indien beschikbaar.

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

Tijdstempel van mislukking indien beschikbaar.

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

Tijdstempel van time-out indien beschikbaar.

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

URL van de vertaalde video.

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

URL van vertaalde audio.

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

Openbare instellingen gebruikt voor de vertaalde versie, zoals ondertitels, SmartSync, achtergrondaudio en kwaliteitsmodus.

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

`translate` wanneer VoiceCheap het transcript met de vertaalengine en SmartSync heeft vertaald, `dub-only` wanneer de tekst uit een door u geleverde `translatedSrt` komt (zie [Project nasynchroniseren](https://api-docs.voicecheap.ai/docs/nl/api-reference/dub-project.md)). Alleen-nasynchronisatieversies melden altijd `smartSync: false`.

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

Foutcode en bericht wanneer de vertaalde versie is mislukt.

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

Geschiedenis van lipsynchronisatie voor de vertaalde versie, alleen aanwezig wanneer lipsynchronisatie is aangevraagd.

**lipSync-eigenschappen**

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

Laatste poging tot lipsynchronisatie.

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

Alle pogingen tot lipsynchronisatie voor deze vertaalde versie, in volgorde van creatie.

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

Identificatiecode voor lipsynchronisatietaak.

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

Status van lipsynchronisatie: `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `REJECTED` of `CANCELED`.

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

URL van video met lipsynchronisatie wanneer voltooid.

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

Modus voor lipsynchronisatie: `standard`, `pro` of `studio`.

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

Of actieve sprekerdetectie was ingeschakeld voor deze poging.

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

Status van dynamische ondertitels wanneer beschikbaar.

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

Status van openbare publicatiepoging wanneer beschikbaar.

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

Openbare gepubliceerde videoreferenties wanneer beschikbaar.

## Voorbeeld

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

## Fouten

| Status | Code | Beschrijving |
| - | - | - |
| 401 | `MISSING_API_KEY` | API-sleutel is vereist |
| 401 | `INVALID_API_KEY` | De verstrekte API-sleutel is ongeldig |
| 403 | `FORBIDDEN` | U heeft geen toestemming om toegang te krijgen tot het project |
| 404 | `PROJECT_NOT_FOUND` | Het project bestaat niet |
| 429 | `RATE_LIMIT_EXCEEDED` | Te veel verzoeken |
| 500 | `INTERNAL_ERROR` | Onverwachte serverfout |


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