API 참조

텍스트 음성 변환

POST/v1/audio/speech

음성을 합성하고 성공 시 모델별 오디오 바이트를 반환합니다. 기본 형식은 선택한 모델이 결정합니다. 파일 보관이 활성화되면 X-Gloop-File-Id/X-Gloop-Storage-Status 등의 응답 헤더가 저장 단계를 설명합니다. 오디오를 JSON으로 취급하지 마세요.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

요청 본문 · application/json

유형: object
필수 필드: modelinputvoice

요청 본문 필수

modelstring필수
inputstring필수
합성할 텍스트입니다. 길이 제한은 선택한 모델에 따라 다르며 공통 4096자 제한은 없습니다.
voicestring필수
구체적인 지원과 제한은 선택한 모델에 따라 다르며 공통 기본값은 보장되지 않습니다.
response_formatstring선택 사항
요청한 오디오 출력 형식입니다. 지원 값과 생략 시 사용 형식은 선택한 모델에 따라 다릅니다. 플랫폼의 일반 엔드포인트는 mp3를 기본값으로 지정하지 않습니다.
speednumber선택 사항
구체적인 지원과 제한은 선택한 모델에 따라 다르며 공통 기본값은 보장되지 않습니다.
instructionsstring선택 사항
모델별 음성 지침입니다.
stream_formatstring선택 사항
모델별 스트리밍 형식이며 모든 모델의 SSE 지원을 보장하지 않습니다.

응답과 오류

HTTP 200

오디오 생성 성공

audio/mpeg

유형: string
형식: binary
설명: 오디오 바이트 스트림입니다. 파일로 저장하세요.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/wav

유형: string
형식: binary
설명: 오디오 바이트 스트림입니다. 파일로 저장하세요.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/ogg

유형: string
형식: binary
설명: 오디오 바이트 스트림입니다. 파일로 저장하세요.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/flac

유형: string
형식: binary
설명: 오디오 바이트 스트림입니다. 파일로 저장하세요.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

audio/aac

유형: string
형식: binary
설명: 오디오 바이트 스트림입니다. 파일로 저장하세요.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

application/octet-stream

유형: string
형식: binary
설명: 오디오 바이트 스트림입니다. 파일로 저장하세요.

{
  "type": "string",
  "format": "binary",
  "description": "音频字节流，保存为文件。"
}

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항