> ## 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 형식으로 검색

# 프로젝트 대본 내보내기

내부 웹 앱 엔드포인트를 사용하지 않고 기존 VoiceCheap 프로젝트에서 대본을 검색합니다. 이 엔드포인트는 원본 대본과 사용 가능한 모든 대상 언어 대본을 지원합니다.
성공적인 요청은 HTTP `200`을 반환합니다.

## 요청

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

귀하의 VoiceCheap API 키.

**projectId** `string` *required*

[프로젝트 생성](https://api-docs.voicecheap.ai/docs/ko/api-reference/create-project.md) 또는 [더빙 시작](https://api-docs.voicecheap.ai/docs/ko/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/ko/api-reference/transcribe.md)에 문서화된 것과 동일한 정규화된 대본 구조를 사용합니다. 저장된 프로젝트 대본에는 세그먼트 타임스탬프, 화자, 언어, 사용 가능한 경우 신뢰도 데이터, 그리고 번역된 출력을 위한 `workId`이 포함됩니다.

## 번역 세그먼트 속도

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

세그먼트 음성이 생성된 뒤의 번역 전사에만 있습니다. 생성된 음성 길이와 세그먼트 구간의 비율이며, 최종 템포 보정 전에 측정하고 소수점 셋째 자리로 반올림합니다. `1`은 음성이 자연스럽게 맞는다는 뜻입니다. 대략 `1.3`을 넘으면 오디오를 눈에 띄게 빠르게 해야 했고, `0.9` 미만이면 느리게 했다는 뜻입니다.

[더빙 전용 실행](https://api-docs.voicecheap.ai/docs/ko/api-reference/translate.md#dub-only-mode-bring-your-own-translation)을 조정하는 데 사용합니다. 번역 전사를 JSON으로 내보내고 `finalSpeedFactor`가 너무 높은 큐를 줄인 다음, 수정한 SRT를 [프로젝트 더빙](https://api-docs.voicecheap.ai/docs/ko/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.