Tổng hợp giọng nói

Gửi các tham số như văn bản, giọng nói và định dạng đầu ra; nội dung phản hồi là âm thanh nhị phân. Ứng dụng khách nên lưu hoặc xử lý kết quả theo định dạng đầu ra đã yêu cầu.

POST/v1/audio/speech

Chuyển văn bản đầu vào thành giọng nói và trả về kết quả dưới dạng nội dung âm thanh nhị phân.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Tham số yêu cầu chuyển văn bản thành giọng nói.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình chuyển văn bản thành giọng nói, chẳng hạn tts-1 và tts-1-hd. Mô hình khả dụng thực tế tùy thuộc vào danh sách mô hình mà API Key hiện tại trả về.

Độ dài1 <= length

input*string

Văn bản cần chuyển thành giọng nói, tối đa 4096 ký tự.

Độ dài1 <= length <= 4096

voice*string

Giọng được sử dụng để tạo giọng nói.

Giá trị được phép

"alloy"
"ash"
"ballad"
"coral"
"echo"
"fable"
"nova"
"onyx"
"sage"
"shimmer"
"verse"
"marin"
"cedar"

instructions?string

Điều khiển giọng điệu, cách thể hiện hoặc các yêu cầu khác khi nói.

Độ dàilength <= 4096

response_format?string

Định dạng âm thanh đầu ra.

Giá trị mặc định"mp3"

Giá trị được phép

"mp3"
"opus"
"aac"
"flac"
"wav"
"pcm"

speed?number

Tốc độ tạo giọng nói, trong khoảng 0.25 đến 4.0.

Phạm vi0.25 <= value <= 4

Giá trị mặc định1

stream_format?string

Định dạng phản hồi dạng luồng. audio trả về luồng âm thanh nhị phân; sse trả về các sự kiện âm thanh có ngữ nghĩa.

Giá trị mặc định"audio"

Giá trị được phép

"audio"
"sse"

Nội dung phản hồi

`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": "Xin chào thế giới!",    "voice": "alloy"  }' \  --output speech.mp3

Nội dung phản hồi không phải JSON. Lưu nội dung nhị phân thành tệp âm thanh theo định dạng đầu ra đã yêu cầu.

<binary audio data>

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/octet-stream

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`