Skip to main content
앱에 음성 출력, 전사, 번역 중 어떤 기능이 필요한지에 따라 CometAPI 오디오 모델 문서를 선택해 사용하세요. 오디오 엔드포인트는 다른 OpenAI 호환 엔드포인트와 동일한 CometAPI API 키 패턴을 사용합니다.

오디오 API 선택하기

음성 생성

텍스트를 음성으로 변환합니다.

음성 전사

오디오를 텍스트로 전사합니다.

번역

오디오를 영어 텍스트로 번역합니다.

음성 생성

Models page 또는 model directory에서 오디오를 지원하는 model ID를 사용하세요. 아래 예시는 speech 엔드포인트를 호출합니다.
이 예시에서는 your-audio-model-id 플레이스홀더를 사용합니다. 요청을 실행하기 전에 Models page 또는 model directory에서 사용 가능한 오디오 model ID로 교체하세요.
playground와 엔드포인트 스키마를 사용하려면 Create speech를 여세요.

응답 예시

성공적인 speech 응답은 바이너리 오디오입니다. HTTP 응답은 다음과 같을 수 있습니다:

모델 레코드 예시

이 예시 모델 카탈로그 응답은 /api/models 엔벌로프와 하나의 오디오 모델 레코드 형태를 보여줍니다. 완전한 모델 목록은 아닙니다.
cURL

일반적인 오류

엔드포인트 페이지에 문서화된 형식을 사용하세요.
오디오 파일을 압축하거나 작업을 더 작은 파일로 나누세요.
파일에 음성이 포함되어 있는지, 그리고 필드 이름이 문서와 일치하는지 확인하세요.
https://api.cometapi.com/v1를 사용하세요.

오류 코드와 재시도 전략

텍스트, 파일, model ID, voice 또는 format을 수정할 때까지 재시도하지 마세요.
API 키가 존재하고 유효할 때까지 재시도하지 마세요.
재시도하기 전에 base URL, path, model ID를 확인하세요.
재시도하기 전에 업로드 크기를 줄이세요.
지수 백오프를 사용해 재시도하고 동시성을 줄이세요.
일시적인 provider 또는 서비스 오류에는 백오프를 적용해 재시도하세요.
구현 패턴은 오류 코드와 재시도 전략Rate limits and concurrency를 참고하세요.

가격 및 모델 디렉터리

모델 페이지

CometAPI가 문서에서 model IDs를 어떻게 제공하는지 알아보세요.

모델 디렉터리

사용 가능한 모델과 기능을 살펴보세요.

가격

모델을 호출하기 전에 가격을 확인하세요.
마지막 수정일 2026년 6월 23일