> ## 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`が返されます。

## リクエスト

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

あなたのVoiceCheap APIキー。

**projectId** `string` *required*

[プロジェクトを作成](https://api-docs.voicecheap.ai/docs/ja/api-reference/create-project.md)または[翻訳を開始](https://api-docs.voicecheap.ai/docs/ja/api-reference/translate.md)によって返されるプロジェクト識別子。

**source** `string` *required*

`original`または`translated`。

**targetLanguage** `string`

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

**outputFormat** `string` (default: json)

`json`、`srt`、または`vtt`。

**includeSpeakerLabels** `boolean` (default: false)

SRTまたはVTTに表示可能な話者ラベルを含めます。JSONには常に話者番号が含まれます。

## 例

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

## 翻訳セグメントのペース

**segments\[].finalSpeedFactor** `number`

セグメントの音声が生成されたあとの翻訳済み文字起こしだけです。生成された音声の長さとセグメント枠の比率で、最終的なテンポ調整の前に測り、小数第 3 位に丸めます。`1` は自然に収まることを意味します。おおよそ `1.3` を超えると音声を明らかに速くする必要があり、`0.9` 未満は遅くしたことを意味します。

[吹き替えのみの実行](https://api-docs.voicecheap.ai/docs/ja/api-reference/translate.md#dub-only-mode-bring-your-own-translation)を調整するために使います。翻訳済み文字起こしを JSON で書き出し、`finalSpeedFactor` が高すぎるキューを短くして、改訂した SRT を[プロジェクトの吹き替え](https://api-docs.voicecheap.ai/docs/ja/api-reference/dub-project.md)へ送ってください。この値はそのセグメントで最後に生成された音声を表すため、実行のたびに更新されます。

## エラー

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


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