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

# Projekt löschen

> Ein Übersetzungsprojekt dauerhaft löschen

# Projekt löschen

Ein Übersetzungsprojekt und die damit verbundenen Assets dauerhaft löschen.

Projektdatensätze werden immer gelöscht. Das Löschen von Medien erfolgt nach bestem Bemühen: Wenn eine gespeicherte Datei nicht entfernt werden kann oder bereits vor Abschluss der Löschung entfernt wurde, protokolliert die Bereinigung dies, fährt fort und schließt die Projektlöschung dennoch ab. Eine generierte Datei kann daher gelegentlich im Speicher verbleiben.

> [!WARNING]
>
> Dieser Vorgang ist unwiderruflich. Das Projekt, seine Arbeiten, alle Transkriptdatensätze und alle generierten Medien werden gelöscht.

## Was gelöscht wird

* Der Projektdatensatz und jede damit verbundene Übersetzungsarbeit (eine pro Zielsprache).
* Die Segmente des Originaltranskripts und jedes übersetzte Transkriptsegment, einschließlich des Textes, den Sie über `translatedSrt` übermittelt haben.
* Alle für das Projekt generierten Medien: synchronisierte Videos und Audiospuren, Lippensynchron-Videos, Wellenformen, die isolierten Stimm- und Hintergrundspuren sowie die pro Segment erzeugten Sprachdateien für jedes übersetzte Segment.
* Die hochgeladene Quelldatei und das extrahierte Originalaudio.
* Die für das Projekt generierten Vorschau-Samples geklonter Stimmen.

Das Löschen eines Projekts gibt den von den oben genannten Assets belegten Speicher frei. Datensätze, die auf das Projekt verweisen, werden für jedes Konto entfernt, das Zugriff darauf hatte (Eigentümer und Teammitglieder).

## Was nicht gelöscht wird

* Benutzerdefinierte Stimmen, die in der Stimmbibliothek Ihres Kontos gespeichert sind. Sie werden projektübergreifend genutzt; entfernen Sie sie aus der Stimmbibliothek, wenn Sie sie löschen möchten.
* Kopien bei den Verarbeitungspartnern, die die Transkription, die Übersetzung oder die Stimmen erzeugt haben. Diese Kopien unterliegen der jeweiligen Aufbewahrungsfrist des Partners und sind über VoiceCheap nicht zugänglich.
* Bereits für das Projekt abgerechnete Minuten werden nicht erstattet.

## Anfrage

### Header

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

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

### Pfadparameter

**projectId** `string` *required*

Die eindeutige Kennung des zu löschenden Übersetzungsprojekts.

## Antwort

**success** `boolean` *required*

Gibt an, dass der Löschvorgang erfolgreich abgeschlossen wurde.

**message** `string` *required*

Für Menschen lesbare Bestätigungsnachricht.

**projectId** `string` *required*

Die ID des gelöschten Projekts.

## Beispiele

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

```typescript TypeScript theme={null}
interface DeleteProjectResponse {
  success: true;
  message: string;
  projectId: string;
}

async function deleteProject(projectId: string): Promise<DeleteProjectResponse> {
  const response = await fetch(
    `https://api.voicecheap.ai/v1/translate/${projectId}`,
    {
      method: 'DELETE',
      headers: {
        'x-api-key': 'vc_your-api-key',
      },
    },
  );

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.message || 'Failed to delete project');
  }

  return response.json();
}

// Usage
deleteProject('abc123-def456-ghi789')
  .then((result) => console.log('Deleted:', result.projectId))
  .catch((error) => console.error('Error:', error));
```

```python Python theme={null}
import requests

project_id = 'abc123-def456-ghi789'
headers = {'x-api-key': 'vc_your-api-key'}

response = requests.delete(
    f'https://api.voicecheap.ai/v1/translate/{project_id}',
    headers=headers
)

if not response.ok:
    error = response.json()
    raise Exception(error.get('message', 'Failed to delete project'))

result = response.json()
print(f"Deleted: {result['projectId']}")
```

```php PHP theme={null}
<?php
$apiKey = 'vc_your-api-key';
$projectId = 'abc123-def456-ghi789';

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.voicecheap.ai/v1/translate/{$projectId}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        "x-api-key: {$apiKey}"
    ]
]);

$response = curl_exec($curl);
$result = json_decode($response, true);

if (!isset($result['success'])) {
    $message = $result['message'] ?? 'Failed to delete project';
    throw new Exception($message);
}

echo "Deleted: " . $result['projectId'];
```

## Fehler

| Status | Code | Beschreibung |
| - | - | - |
| 401 | `INVALID_API_KEY` | Der bereitgestellte API-Schlüssel ist ungültig |
| 403 | `FORBIDDEN` | Sie haben keine Berechtigung, dieses Projekt zu löschen |
| 404 | `PROJECT_NOT_FOUND` | Das angegebene Projekt existiert nicht |
| 429 | `RATE_LIMIT_EXCEEDED` | Zu viele Anfragen (Limit: 10 Anfragen pro Minute) |
| 500 | `INTERNAL_ERROR` | Unerwarteter Serverfehler |


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