오디오 처리

개요

AGTCloud의 오디오 API는 음성 합성, 오디오 전사와 번역을 제공합니다. 세 작업은 서로 다른 입력 방식을 사용하며 오디오 파일 또는 텍스트 결과를 반환합니다.

지원하는 작업 유형

유형	설명	주요 결과
음성 합성	텍스트를 음성으로 변환합니다	바이너리 오디오
오디오 전사	오디오를 원래 언어의 텍스트로 변환합니다	JSON, 텍스트 또는 자막
오디오 번역	오디오를 영어 텍스트로 변환합니다	JSON, 텍스트 또는 자막

API 연동

Base URL

https://api.agtcloud.cn/v1

음성 합성

curl 'https://api.agtcloud.cn/v1/audio/speech' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "input": "AGTCloud에 오신 것을 환영합니다.",
    "voice": "alloy"
  }' \
  --output speech.mp3

매개변수	필수	설명
`model`	예	텍스트를 음성으로 변환하는 모델 ID
`input`	예	음성으로 변환할 텍스트
`voice`	예	생성할 음성의 목소리
`response_format`	아니요	오디오 출력 형식
`speed`	아니요	음성 생성 속도

Speech는 오디오 바이트를 반환합니다. 실제 응답 형식에 맞게 저장해야 하며 JSON으로 해석해서는 안 됩니다.

오디오 전사

curl 'https://api.agtcloud.cn/v1/audio/transcriptions' \
  -H 'Authorization: Bearer your-api-key' \
  -F 'file=@meeting.mp3' \
  -F 'model=MODEL_ID'

매개변수	필수	설명
`file`	예	전사할 오디오 파일
`model`	예	오디오 전사 모델 ID
`language`	아니요	입력 오디오의 ISO-639-1 언어 코드
`response_format`	아니요	전사 결과의 출력 형식

Transcriptions는 Multipart로 오디오를 업로드합니다. 기본 JSON 응답에서 전사 텍스트는 text 필드에 있습니다.

오디오 번역

curl 'https://api.agtcloud.cn/v1/audio/translations' \
  -H 'Authorization: Bearer your-api-key' \
  -F 'file=@chinese.mp3' \
  -F 'model=MODEL_ID'

매개변수	필수	설명
`file`	예	번역할 영어 이외 언어의 오디오 파일
`model`	예	오디오 번역 모델 ID
`prompt`	아니요	출력 스타일을 안내하는 영어 텍스트
`response_format`	아니요	번역 결과의 출력 형식

Translations는 영어 텍스트를 반환합니다. 기본 JSON 응답의 결과는 text 필드에 있습니다.

응답 처리

API	응답 처리
Speech	응답 형식에 맞춰 바이너리 오디오를 저장합니다
Transcriptions	`response_format`에 따라 JSON, 텍스트 또는 자막을 처리합니다
Translations	`response_format`에 따라 영어 텍스트 결과를 처리합니다

개요