음성 합성

요청 본문의 input으로 합성할 텍스트를 제출하며 OpenAI Audio Speech 요청 구조를 사용하는 클라이언트에 적합합니다.

POST/v1/audio/speech

OpenAI Audio Speech 요청 구조로 Hailuo 음성 합성 요청을 제출합니다. 플랫폼은 모델 ID에 따라 해당 Hailuo 음성 기능으로 라우팅합니다.

현재 표시되는 모델에는 speech-2.8-hd, speech-2.8-turbo, speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo, speech-01-hd, speech-01-turbo가 있습니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

Hailuo 음성 합성 요청입니다.

TypeScript 타입 정의

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

model*string

Hailuo 음성 모델 ID입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

input*string

음성으로 합성할 텍스트입니다.

길이1 <= length

voice*string

음성 생성에 사용하는 목소리입니다.

길이1 <= length

[key: string]?any

응답 본문

`audio/mpeg`

`application/json`

curl -X POST "https://example.com/v1/audio/speech" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "Hailuo 음성 합성 시스템에 오신 것을 환영합니다. 고품질 음성 서비스를 제공합니다.",
    "voice": "alloy"
  }' \
  --output speech.mp3

응답 예시가 없습니다

음성 합성에 성공했으며 MP3 오디오 바이너리 데이터를 반환합니다.

인증

요청 본문

응답 본문

200audio/mpeg

401application/json

`audio/mpeg`

`application/json`