> ## 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`을 반환합니다.

## 요청

<ParamField header="x-api-key" type="string" required>
  귀하의 VoiceCheap API 키.
</ParamField>

<ParamField path="projectId" type="string" required>
  [프로젝트 생성](/docs/ko/api-reference/create-project) 또는 [더빙 시작](/docs/ko/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/ko/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`     | 요청한 대본이 아직 처리 중입니다         |