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

# Excluir Projeto

> Excluir permanentemente um projeto de tradução

# Excluir Projeto

Excluir permanentemente um projeto de tradução e seus ativos associados.

Os registros do projeto são sempre excluídos. A exclusão de mídias é feita em modo de melhor esforço: se um arquivo armazenado não puder ser removido, ou já tiver sido removido antes da conclusão da exclusão, a limpeza registra isso, continua e ainda finaliza a exclusão do projeto. Portanto, um arquivo gerado pode ocasionalmente permanecer no armazenamento.

> [!WARNING]
>
> Esta operação é irreversível. O projeto, seus trabalhos, todos os registros de transcrição e todas as mídias geradas são excluídos.

## O que é excluído

* O registro do projeto e cada trabalho de tradução vinculado a ele (um por idioma de destino).
* Os segmentos da transcrição original e cada segmento de transcrição traduzido, incluindo o texto que você forneceu por meio de `translatedSrt`.
* Todas as mídias geradas para o projeto: vídeos e faixas de áudio dublados, vídeos com sincronização labial, formas de onda, as faixas de voz isolada e de fundo, e os arquivos de fala por segmento produzidos para cada segmento traduzido.
* O arquivo de origem enviado e o áudio original extraído.
* As amostras de pré-visualização de vozes clonadas geradas para o projeto.

Excluir um projeto libera o armazenamento usado pelos ativos acima. Os registros que fazem referência ao projeto são removidos de todas as contas que tinham acesso a ele (proprietário e membros da equipe).

## O que não é excluído

* Vozes personalizadas salvas na biblioteca de vozes da sua conta. Elas são compartilhadas entre projetos; remova-as da biblioteca de vozes se quiser excluí-las.
* Cópias mantidas pelos parceiros de processamento que produziram a transcrição, a tradução ou as vozes. Essas cópias seguem o período de retenção de cada parceiro e não são acessíveis pela VoiceCheap.
* Os minutos já cobrados pelo projeto não são reembolsados.

## Solicitação

### Cabeçalhos

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

Sua chave de API VoiceCheap. Obtenha uma em [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Parâmetros de Caminho

**projectId** `string` *required*

O identificador único do projeto de tradução a ser excluído.

## Resposta

**success** `boolean` *required*

Indica que a operação de exclusão foi concluída com sucesso.

**message** `string` *required*

Mensagem de confirmação legível por humanos.

**projectId** `string` *required*

O ID do projeto excluído.

## Exemplos

```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'];
```

## Erros

| Status | Código | Descrição |
| - | - | - |
| 401 | `INVALID_API_KEY` | A chave de API fornecida é inválida |
| 403 | `FORBIDDEN` | Você não tem permissão para excluir este projeto |
| 404 | `PROJECT_NOT_FOUND` | O projeto especificado não existe |
| 429 | `RATE_LIMIT_EXCEEDED` | Muitas solicitações (limite: 10 solicitações por minuto) |
| 500 | `INTERNAL_ERROR` | Erro inesperado do servidor |


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