> ## 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](/docs/nl/api-reference/translation-status) gebruiken. Dit eindpunt is rijker en retourneert opzettelijk meer gegevens.
## Verzoek
### Headers
Uw VoiceCheap API-sleutel. Haal er een op via [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).
### Padparameters
De unieke identificatiecode van het project geretourneerd door [Project aanmaken](/docs/nl/api-reference/create-project) of [Vertaling starten](/docs/nl/api-reference/translate).
## Antwoord
De unieke identificatiecode van het project.
De projectnaam.
Openbare projectstatus: `processing`, `success` of `failed`.
API-workflow: `translation` of `transcription`. Transcriptieworkflows bereiken succes wanneer de brontranscriptie is voltooid.
URL naar het oorspronkelijk geüploade video- of audiobestand.
De gedetecteerde of opgegeven brontaal.
Doeltalen gekoppeld aan het project.
Duur van de inhoud in seconden.
Unix-tijdstempel waarop het project is aangemaakt.
Huidige voortgang op projectniveau.
Huidige stap voor het aanmaken of transcriberen van het project.
Geschat voortgangspercentage van het aanmaken/transcriberen van het project.
Status van brontranscriptie: `processing`, `success` of `failed`.
Vertaalde versiegeschiedenis, gesorteerd met de nieuwste versie eerst.
Identificatiecode voor vertaalwerk.
Identificatiecode voor vertaalde versie.
Doeltaal voor deze versie.
Status van vertaalversie: `in-progress`, `completed`, `not-started` of `failed`.
Huidige stap voor nasynchronisatie voor deze versie.
Geschat voortgangspercentage van nasynchronisatie.
Tijdstempel waarop deze vertaalde versie is aangemaakt.
Tijdstempel van voltooiing indien beschikbaar.
Tijdstempel van mislukking indien beschikbaar.
Tijdstempel van time-out indien beschikbaar.
URL van de vertaalde video.
URL van vertaalde audio.
Openbare instellingen gebruikt voor de vertaalde versie, zoals ondertitels, SmartSync, achtergrondaudio en kwaliteitsmodus.
Foutcode en bericht wanneer de vertaalde versie is mislukt.
Geschiedenis van lipsynchronisatie voor de vertaalde versie, alleen aanwezig wanneer lipsynchronisatie is aangevraagd.
Laatste poging tot lipsynchronisatie.
Alle pogingen tot lipsynchronisatie voor deze vertaalde versie, in volgorde van creatie.
Identificatiecode voor lipsynchronisatietaak.
Status van lipsynchronisatie: `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `REJECTED` of `CANCELED`.
URL van video met lipsynchronisatie wanneer voltooid.
Modus voor lipsynchronisatie: `standard`, `pro` of `studio`.
Of actieve sprekerdetectie was ingeschakeld voor deze poging.
Status van dynamische ondertitels wanneer beschikbaar.
Status van openbare publicatiepoging wanneer beschikbaar.
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,
"voiceIsolatorOption": "studio",
"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 |