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

# Projektdetails abrufen

> Öffentliche Projektdetails, Verlauf der übersetzten Versionen und Verlauf der Lippensynchronisation abrufen

# Projektdetails abrufen

Abrufen einer normalisierten öffentlichen Ansicht eines Projekts. Verwenden Sie diesen Endpunkt, wenn Sie den Verlauf der übersetzten Versionen, den Verlauf der Lippensynchronisation, den Status der dynamischen Untertitel oder den Veröffentlichungsstatus benötigen.

Für häufiges Abfragen verwenden Sie weiterhin [Übersetzungsstatus abrufen](https://api-docs.voicecheap.ai/docs/de/api-reference/translation-status.md). Dieser Endpunkt ist umfangreicher und liefert absichtlich mehr Daten.

## Anfrage

### Header

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

Ihr VoiceCheap API-Schlüssel. Erhalten Sie einen von [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Pfadparameter

**projectId** `string` *required*

Die eindeutige Kennung des Projekts, die von [Projekt erstellen](https://api-docs.voicecheap.ai/docs/de/api-reference/create-project.md) oder [Übersetzung starten](https://api-docs.voicecheap.ai/docs/de/api-reference/translate.md) zurückgegeben wird.

## Antwort

**projectId** `string` *required*

Die eindeutige Kennung des Projekts.

**projectName** `string` *required*

Der Projektname.

**status** `string` *required*

Öffentlicher Projektstatus: `processing`, `success` oder `failed`.

**workflow** `string` *required*

API-Workflow: `translation` oder `transcription`. Transkriptions-Workflows erreichen den Erfolg, wenn die Quelltranskription abgeschlossen ist.

**originalVideoUrl** `string` *required*

URL zur ursprünglich hochgeladenen Video- oder Audiodatei.

**originalLanguage** `string` *required*

Die erkannte oder angegebene Originalsprache.

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

Zielsprachen, die mit dem Projekt verknüpft sind.

**duration** `number` *required*

Dauer des Inhalts in Sekunden.

**createdAt** `number` *required*

Unix-Zeitstempel, wann das Projekt erstellt wurde.

**progress** `object` *required*

Aktueller Fortschritt auf Projektebene.

**Fortschrittseigenschaften**

**progress.step** `string`

Aktueller Schritt der Projekterstellung oder Transkription.

**progress.transcriptionProgress** `number`

Ungefährer Prozentsatz des Fortschritts bei der Projekterstellung/Transkription.

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

Status der Quelltranskription: `processing`, `success` oder `failed`.

**translations** `array` *required*

Verlauf der übersetzten Versionen, sortiert mit der neuesten Version zuerst.

**Übersetzungseigenschaften**

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

Kennung der Übersetzungsarbeit.

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

Kennung der übersetzten Version.

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

Zielsprache für diese Version.

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

Status der Übersetzungsversion: `in-progress`, `completed`, `not-started` oder `failed`.

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

Aktueller Synchronisationsschritt für diese Version.

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

Ungefährer Prozentsatz des Synchronisationsfortschritts.

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

Zeitstempel, wann diese übersetzte Version erstellt wurde.

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

Zeitstempel der Fertigstellung, falls verfügbar.

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

Zeitstempel des Fehlers, falls verfügbar.

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

Zeitstempel des Timeouts, falls verfügbar.

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

URL des übersetzten Videos.

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

URL des übersetzten Audios.

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

Öffentliche Einstellungen für die übersetzte Version, wie Untertitel, SmartSync, Hintergrundaudio und Qualitätsmodus.

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

`translate`, wenn VoiceCheap das Transkript mit der Übersetzungs-Engine und SmartSync übersetzt hat, `dub-only`, wenn der Text aus einem von Ihnen gelieferten `translatedSrt` stammt (siehe [Projekt synchronisieren](https://api-docs.voicecheap.ai/docs/de/api-reference/dub-project.md)). Nur-Synchronisationsversionen melden immer `smartSync: false`.

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

Fehlercode und Nachricht, wenn die übersetzte Version fehlgeschlagen ist.

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

Verlauf der Lippensynchronisation für die übersetzte Version, nur vorhanden, wenn eine Lippensynchronisation angefordert wurde.

**Eigenschaften der Lippensynchronisation**

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

Letzter Versuch der Lippensynchronisation.

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

Alle Versuche der Lippensynchronisation für diese übersetzte Version, in der Reihenfolge der Erstellung.

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

Auftragskennung der Lippensynchronisation.

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

Status der Lippensynchronisation: `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `REJECTED` oder `CANCELED`.

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

URL des lippensynchronisierten Videos nach Fertigstellung.

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

Modus der Lippensynchronisation: `standard`, `pro` oder `studio`.

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

Ob die Erkennung aktiver Sprecher für diesen Versuch aktiviert war.

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

Status der dynamischen Untertitel, falls verfügbar.

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

Status des öffentlichen Veröffentlichungsversuchs, falls verfügbar.

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

Öffentliche Referenzen des veröffentlichten Videos, falls verfügbar.

## Beispiel

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

## Fehler

| Status | Code | Beschreibung |
| - | - | - |
| 401 | `MISSING_API_KEY` | API-Schlüssel ist erforderlich |
| 401 | `INVALID_API_KEY` | Der bereitgestellte API-Schlüssel ist ungültig |
| 403 | `FORBIDDEN` | Sie haben keine Berechtigung, auf das Projekt zuzugreifen |
| 404 | `PROJECT_NOT_FOUND` | Das Projekt existiert nicht |
| 429 | `RATE_LIMIT_EXCEEDED` | Zu viele Anfragen |
| 500 | `INTERNAL_ERROR` | Unerwarteter Serverfehler |


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