파일 전사

WAV 오디오 파일을 업로드하고 Muse Voice Transcribe로 전사 결과를 반환합니다.

전체 WAV 오디오 파일을 업로드하고 Muse Voice Transcribe로 JSON, SSE 또는 일반 텍스트 전사 결과를 가져옵니다. 파일은 모노, 16-bit integer PCM이어야 하며 샘플링 레이트는 16 kHz 또는 24 kHz입니다.

curl --fail-with-body 'https://api.agtcloud.cn/v1/asr/transcribe' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Accept: application/json' \
  -F 'request={"model":"muse-voice-transcribe-1.0","audioEncoding":"WAV","mode":"DIARIZATION","languageBias":["Mandarin Chinese"]};type=application/json' \
  -F 'audio=@audio.wav;type=audio/wav'

POST/v1/asr/transcribe

Multipart로 JSON 설정과 WAV 오디오를 함께 제출합니다. 오디오는 모노, 16-bit integer PCM WAV여야 하며 샘플링 레이트는 16 kHz 또는 24 kHz, 길이는 600초 이하여야 합니다. 전체 요청 본문은 32 MiB를 넘을 수 없습니다.

Accept로 JSON, SSE 또는 일반 텍스트 응답을 선택합니다. 사용 가능한 모델 범위는 현재 API 키와 모델 카탈로그를 기준으로 합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

multipart/form-data

request 부분에는 JSON을 사용하고 audio 부분에는 WAV 파일을 업로드합니다. 클라이언트가 Multipart boundary를 자동 생성하도록 해야 합니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

request*

audio*file

모노, 16-bit integer PCM WAV 파일입니다. 샘플링 레이트는 16 kHz 또는 24 kHz, 길이는 600초 이하여야 합니다.

형식binary

응답 본문

{
  "sessionId": "example-session",
  "transcript": "안녕하세요, 들리시나요?",
  "audioDurationMs": 4300,
  "turns": [
    {
      "turnId": 0,
      "startMs": 120,
      "endMs": 4200,
      "transcript": "안녕하세요, 들리시나요?",
      "speaker": "A"
    }
  ]
}

인증

요청 본문

응답 본문

200application/json

400

406

413