Sinh nhạc (Lyria 3)

POST /audio/speech

Sinh một bản nhạc từ mô tả bằng chữ. Dùng chung endpoint với Text-to-Speech, khác ở tên model.

Tham khảo

Hướng dẫn chi tiết và cách viết prompt: Sinh nhạc với Lyria 3. Tài liệu gốc: Lyria 3 (Google).

Cấu trúc yêu cầu (Request Body)

modelstringRequired

lyria-3-clip-preview (bài khoảng 30 giây, $0.04) hoặc lyria-3-pro-preview (bài khoảng 3 phút, $0.08).

inputstringRequired

Mô tả bản nhạc: thể loại, tâm trạng, nhạc cụ, nhịp độ, giọng hát, lời bài hát.

voicestringRequired

Lyria không dùng giọng đọc. Gửi default.

response_formatstring

mp3 (mặc định). Riêng lyria-3-pro-preview nhận thêm wav.

---

Cấu trúc Phản hồi (Response Body)

Phản hồi thành công trả về file âm thanh (audio/mpeg). Header x-litellm-response-cost cho biết chi phí của request.

Lỗi thường gặp

429rate limit

Vượt 105 request/phút của model đó, hoặc hết budget.

curlPython (openai)

curl https://api.thucchien.ai/audio/speech \
-H "Content-Type: application/json" \
-H "Authorization: Bearer " \
-d '{
  "model": "lyria-3-clip-previewlyria-3-pro-preview",
  "input": "Nhạc lo-fi thư giãn, piano và tiếng mưa nhẹ, nhịp chậm",
  "voice": "default"
}' \
--output song.mp3

Example Response

{
  "status": 200,
  "contentType": "audio/mpeg",
  "message": "Response body contains the MP3 file."
}