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

# プロジェクトの削除

> 翻訳プロジェクトを完全に削除します

# プロジェクトの削除

翻訳プロジェクトおよびそれに関連するアセットを完全に削除します。

プロジェクトのレコードは常に削除されます。メディアの削除はベストエフォートで行われます。保存されたファイルを削除できない場合、または削除の完了前に既に削除されていた場合、クリーンアップはそれを記録して続行し、プロジェクトの削除を完了させます。そのため、生成されたファイルがストレージに残ることがまれにあります。

> [!WARNING]
>
> この操作は元に戻せません。プロジェクト、その作品、すべての文字起こしレコード、および生成されたすべてのメディアが削除されます。

## 削除されるもの

* プロジェクトレコードと、それに紐づくすべての翻訳作品（ターゲット言語ごとに 1 つ）。
* 元の文字起こしセグメントとすべての翻訳済み文字起こしセグメント（`translatedSrt` で提供したテキストを含む）。
* プロジェクト用に生成されたすべてのメディア：吹き替え済みの動画と音声トラック、リップシンク動画、波形、分離された音声トラックと背景トラック、および翻訳済みセグメントごとに生成された音声ファイル。
* アップロードされたソースファイルと抽出された元の音声。
* プロジェクト用に生成されたクローン音声のプレビューサンプル。

プロジェクトを削除すると、上記のアセットが使用していたストレージが解放されます。プロジェクトを参照するレコードは、そのプロジェクトにアクセスできたすべてのアカウント（所有者およびチームメンバー）から削除されます。

## 削除されないもの

* アカウントの音声ライブラリに保存されたカスタム音声。これらはプロジェクト間で共有されるため、削除したい場合は音声ライブラリから削除してください。
* 文字起こし、翻訳、または音声を生成した処理パートナーが保持するコピー。これらのコピーは各パートナー独自の保持期間に従い、VoiceCheap からはアクセスできません。
* プロジェクトに対して既に課金された分数は返金されません。

## リクエスト

### ヘッダー

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

あなたのVoiceCheap APIキー。[app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api)から取得してください。

### パスパラメータ

**projectId** `string` *required*

削除する翻訳プロジェクトの一意の識別子。

## レスポンス

**success** `boolean` *required*

削除操作が正常に完了したことを示します。

**message** `string` *required*

人間が読める形式の確認メッセージ。

**projectId** `string` *required*

削除されたプロジェクトのID。

## 例

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

## エラー

| ステータス | コード | 説明 |
| - | - | - |
| 401 | `INVALID_API_KEY` | 提供されたAPIキーは無効です |
| 403 | `FORBIDDEN` | このプロジェクトを削除する権限がありません |
| 404 | `PROJECT_NOT_FOUND` | 指定されたプロジェクトは存在しません |
| 429 | `RATE_LIMIT_EXCEEDED` | リクエストが多すぎます（制限：1分間に10リクエスト） |
| 500 | `INTERNAL_ERROR` | 予期しないサーバーエラー |


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