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

# プロジェクトのトランスクリプトをエクスポート

> オリジナルまたは翻訳済みプロジェクトのトランスクリプトをJSON、SRT、またはVTT形式で取得します

# プロジェクトのトランスクリプトをエクスポート

内部Webアプリのエンドポイントを使用せずに、既存のVoiceCheapプロジェクトからトランスクリプトを取得します。このエンドポイントは、ソースのトランスクリプトおよび利用可能なすべてのターゲット言語のトランスクリプトをサポートしています。
リクエストが成功するとHTTP `200`が返されます。

## リクエスト

<ParamField header="x-api-key" type="string" required>
  あなたのVoiceCheap APIキー。
</ParamField>

<ParamField path="projectId" type="string" required>
  [プロジェクトを作成](/docs/ja/api-reference/create-project)または[翻訳を開始](/docs/ja/api-reference/translate)によって返されるプロジェクト識別子。
</ParamField>

<ParamField body="source" type="string" required>
  `original`または`translated`。
</ParamField>

<ParamField body="targetLanguage" type="string">
  `source`が`translated`の場合に必須です。`french`のように、プロジェクトに保存されているターゲット言語名を使用してください。
</ParamField>

<ParamField body="outputFormat" type="string" default="json">
  `json`、`srt`、または`vtt`。
</ParamField>

<ParamField body="includeSpeakerLabels" type="boolean" default="false">
  SRTまたはVTTに表示可能な話者ラベルを含めます。JSONには常に話者番号が含まれます。
</ParamField>

## 例

```bash cURL — Original JSON theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "original",
    "outputFormat": "json"
  }'
```

```bash cURL — Translated SRT theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "translated",
    "targetLanguage": "french",
    "outputFormat": "srt",
    "includeSpeakerLabels": true
  }' \
  --output project_123-fr.srt
```

JSONレスポンスは、[メディアを文字起こし](/docs/ja/api-reference/transcribe)で文書化されている正規化されたトランスクリプト構造と同じものを使用します。保存されたプロジェクトのトランスクリプトには、セグメントのタイムスタンプ、話者、言語、利用可能な場合の信頼度データ、および翻訳出力用の`workId`が含まれます。

## エラー

| ステータス | コード                        | 説明                             |
| ----- | -------------------------- | ------------------------------ |
| 400   | `TARGET_LANGUAGE_REQUIRED` | 言語を指定せずに翻訳出力をリクエストしました         |
| 401   | `INVALID_API_KEY`          | APIキーが見つからないか無効です              |
| 403   | `FORBIDDEN`                | APIキーはこのプロジェクトにアクセスできません       |
| 404   | `PROJECT_NOT_FOUND`        | プロジェクトが存在しません                  |
| 404   | `TRANSCRIPT_NOT_FOUND`     | 要求されたソースまたは翻訳済みトランスクリプトが存在しません |
| 409   | `TRANSCRIPT_NOT_READY`     | 要求されたトランスクリプトは現在処理中です          |