> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 음성-텍스트 변환

> OpenAI 호환 /audio/transcriptions 엔드포인트로 Venice 음성-텍스트 모델을 이용해 오디오 파일을 전사하세요.

음성-텍스트 변환은 음성 오디오를 문자로 전사합니다. 오디오 파일을 `/audio/transcriptions`로 전송하고 전사 모델을 선택한 뒤 원하는 응답 형식을 지정하세요.

## 기본 사용법

<CodeGroup>
  ```python Python theme={"system"}
  import os

  import requests

  with open("meeting.mp3", "rb") as audio:
      response = requests.post(
          "https://api.venice.ai/api/v1/audio/transcriptions",
          headers={"Authorization": f"Bearer {os.environ['VENICE_API_KEY']}"},
          files={"file": audio},
          data={
              "model": "nvidia/parakeet-tdt-0.6b-v3",
              "response_format": "json",
          },
      )

  response.raise_for_status()
  print(response.json()["text"])
  ```

  ```javascript Node.js theme={"system"}
  import { createReadStream } from "node:fs";
  import FormData from "form-data";

  const form = new FormData();
  form.append("file", createReadStream("meeting.mp3"));
  form.append("model", "nvidia/parakeet-tdt-0.6b-v3");
  form.append("response_format", "json");

  const response = await fetch("https://api.venice.ai/api/v1/audio/transcriptions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
      ...form.getHeaders(),
    },
    body: form,
  });

  if (!response.ok) {
    throw new Error(await response.text());
  }

  const transcript = await response.json();
  console.log(transcript.text);
  ```

  ```bash cURL theme={"system"}
  curl https://api.venice.ai/api/v1/audio/transcriptions \
    -H "Authorization: Bearer $VENICE_API_KEY" \
    --form file=@meeting.mp3 \
    --form model=nvidia/parakeet-tdt-0.6b-v3 \
    --form response_format=json
  ```
</CodeGroup>

## 지원 입력

일반적인 오디오 형식으로는 `mp3`, `mp4`, `mpeg`, `mpga`, `m4a`, `wav`, `webm`, `flac`, `ogg`가 있습니다. 현재 모델 지원과 가격 정보는 [음성-텍스트 모델](/models/speech-to-text) 페이지를 참조하세요.

## 응답 형식

| 형식             | 사용 시점                             |
| -------------- | --------------------------------- |
| `json`         | 단순한 `{ "text": "..." }` 응답을 원할 때. |
| `text`         | JSON 파싱 없이 순수 텍스트를 원할 때.          |
| `srt`          | SubRip 자막이 필요할 때.                 |
| `vtt`          | WebVTT 자막이 필요할 때.                 |
| `verbose_json` | 더 풍부한 타임스탬프 및 세그먼트 메타데이터가 필요할 때.  |

<Tip>
  전사 결과를 미디어 재생과 함께 쓸 경우 자막 형식을 사용하세요. 요약, 검색 또는 후속 채팅 프롬프트로 전사 결과를 넘길 때는 `json`이나 `text`를 사용하세요.
</Tip>

## 프로덕션 팁

* 가능하면 오디오를 선명하게 유지하고 화자가 겹치지 않도록 하세요.
* 워크플로에 낮은 지연 시간이나 손쉬운 재시도가 필요하다면 매우 긴 녹음을 더 작은 청크로 분할하세요.
* 감사 추적을 위해 각 전사 결과와 함께 원본 오디오 경로, 모델 ID, 응답 형식을 저장하세요.

## 관련 리소스

* [오디오 전사 API](/api-reference/endpoint/audio/transcriptions)
* [음성-텍스트 모델](/models/speech-to-text)
* [텍스트-음성 변환 가이드](/guides/media/text-to-speech)