Lyria 3 Clip Preview
Lyria 3 Clip Preview เป็นโมเดลเพลงของ Google สำหรับคลิปสั้น ลูป และพรีวิว รับแรงบันดาลใจจากข้อความหรือภาพแล้วสร้างเพลง 30 วินาทีพร้อมเสียงสเตอริโอ 48 kHz รองรับเสียงร้อง เนื้อร้องที่มีเวลา และการเรียบเรียงดนตรีบรรเลง
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
Lyria 3 Clip Preview เป็นโปรไฟล์สร้างเพลงของ Google สำหรับคลิปสั้น ลูป และพรีวิว รับพรอมป์ต์ข้อความหรือแรงบันดาลใจจากภาพ แล้วคืนข้อความกับเสียง โปรไฟล์ที่เผยแพร่อธิบายคลิป 30 วินาทีพร้อมเสียงสเตอริโอ 48 kHz รวมเสียงร้อง เนื้อร้องที่มีเวลา และการเรียบเรียงเครื่องดนตรีครบชุด
อธิบายช่วงดนตรี
ระบุจุดประสงค์คลิปและอารมณ์ที่ควรสื่อ ธีมเปิดสั้นระบุบทนำที่ไม่หวือหวาและการเข้าท่อนหลักที่ชัดได้ เพลงพื้นหลังระบุจังหวะเร็วช้าและเนื้อเสียงที่ต้องใช้ใต้ฉากภาพได้ บอกว่าผลควรมีเสียงร้องหรือเป็นดนตรีบรรเลง และระบุองค์ประกอบดนตรีที่สำคัญต่อโจทย์
ให้โครงสร้างเล็กพอสำหรับคลิป ระบุส่วนเปิด วลีหลัก และจุดจบหรือลูป หากคำสำคัญ ให้แนวคิดหรือถ้อยคำเนื้อร้องที่ตั้งใจและตรวจผลร้องจริง โจทย์ดนตรีควรแยกเนื้อหาเสียงร้องออกจากคำสั่งเรียบเรียง
แรงบันดาลใจภาพและการเรียบเรียง
เมื่อให้ภาพ อธิบายว่าภาพเพิ่มฉากหรืออารมณ์ใดให้คำขอเพลง ทิวทัศน์สงบและฉากกลางคืนที่คนแน่นบอกคนละทิศทาง แต่บทบาทอารมณ์ที่ต้องการยังควรชัดในข้อความ เก็บภาพกับพรอมป์ต์เมื่อเปรียบเทียบคลิปที่คืนมากับแนวคิดที่ตั้งใจ
ตรวจสมดุลเสียงร้อง เครื่องดนตรี และวลีดนตรีหลัก สำหรับลูป ให้ฟังจุดจบต่อจุดเริ่ม สำหรับพรีวิว ตรวจว่าเวลาสั้นสื่อทิศทางที่ตั้งใจหรือไม่ คลิปที่ประกอบงานตัดต่อควรตรวจคู่กับงานนั้น แทนการฟังเดี่ยวอย่างเดียว
เก็บสิ่งส่งมอบที่ฟังได้
บันทึกเสียงจริงและข้อความประกอบกับโจทย์ ตรวจคุณสมบัติไฟล์เมื่อเตรียมเล่นหรือนำเข้าโปรแกรมตัดต่อ และเก็บข้อมูลเนื้อร้องหรือเวลาที่คำขอคืนมา เพลงคือเอาต์พุตโมเดล ส่วนการตัด ชื่อเรื่อง ทรานซิชันภาพ และมิกซ์ขั้นผลิตสุดท้ายจัดรอบชิ้นงานที่ตรวจแล้วนั้นได้
โปรไฟล์ Clip Preview ที่ตรงนี้เหมาะกับสิ่งส่งมอบดนตรีกระชับ รักษาบทบาทงานสั้นให้แยกเมื่อวางแผนเพลงยาว และเลือกคลิปที่คืนมาด้วยการฟังวลีครบ ถ้อยคำที่ร้อง และจุดจบ
Ailoot · เพลง POST /v1/music/generations google/lyria-3-clip-preview
google/lyria-3-clip-previewเริ่มต้น
Lyria 3 Clip Preview เป็นโมเดลเพลงของ Google สำหรับคลิปสั้น ลูป และพรีวิว รับแรงบันดาลใจจากข้อความหรือภาพแล้วสร้างเพลง 30 วินาทีพร้อมเสียงสเตอริโอ 48 kHz รองรับเสียงร้อง เนื้อร้องที่มีเวลา และการเรียบเรียงดนตรีบรรเลง
- อินพุตที่รองรับ
- ข้อความ
- ผลลัพธ์
- music
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot · เพลง POST /v1/music/generations
- ขาเข้า
text- ขาออก
music- รูปแบบเอาต์พุต
- คลิปเสียงทั้งหมดที่เป็นของคุณ / ลิงก์ JSON
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด google/lyria-3-clip-preview | ค่าเริ่มต้น— |
ฟิลด์prompt | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ความยาวขั้นต่ำ: 1 | ค่าเริ่มต้น— |
ชุดผสมของสื่ออินพุต
text_to_music · จำเป็น: prompt
พารามิเตอร์และวงจรการทำงานของเมธอด
| พารามิเตอร์ | ข้อกำหนด |
|---|---|
พารามิเตอร์material_types | ข้อกำหนดtext |
พารามิเตอร์required | ข้อกำหนดnull |
พารามิเตอร์optional_controls | ข้อกำหนดnull |
วงจรการทำงาน: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · ค่า task_id ที่ส่งกลับมาจริง หรือระเบียนในคลังสื่อ
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
รูปแบบเมธอดและ ID ระบุอย่างแม่นยำ ความสามารถของผู้ให้บริการแยกจากการอนุญาตให้รับคำขอ
ราคา
อัตราค่าบริการเมธอด Ailoot
POST /v1/music/generations- ขาออก
- US$0.04 ต่อคลิป
- อ้างอิงเท่านั้น · ไม่บวกเพิ่ม
- US$0.04 ต่อคำขอ
จำนวนคลิปที่ส่งมอบ × อัตราฐานต่อคลิป ไม่บวกอัตราอ้างอิงต่อคำขอ ตัวอย่างเป็นราคาก่อนการปรับที่เกี่ยวข้อง
1 × US$0.04 = US$0.04
Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →
รายละเอียดอัตราอ้างอิง
ตารางอัตราอ้างอิงระดับโมเดลไม่เปลี่ยนเมธอดที่เลือก ยอดประมาณการ หรือค่าบริการ การคิดค่าบริการจริงใช้อัตราของเมธอด Ailoot ที่เลือก
ตารางอัตราอ้างอิงของโมเดล
ราคาตามการตั้งค่า
| การตั้งค่า | ระดับบริการ | เงื่อนไขบริบท | ค่าบริการ |
|---|---|---|---|
| การตั้งค่าUltra | ระดับบริการstandard | เงื่อนไขบริบท{} | ค่าบริการ ขาออก · ดนตรี US$0.08 ต่อเพลง |
ตัวอย่างคำขอ
Ailoot · เพลง
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
export AILOOT_API_KEY
python3 - <<'PY_RESULT'
import json, os, subprocess
from pathlib import Path
from urllib.parse import urljoin, urlparse
result=json.loads(Path("result.json").read_text(encoding="utf-8"))
print(json.dumps(result,ensure_ascii=False,indent=2))
for number,clip in enumerate(result.get("data") or []):
u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))
if u.scheme!="https" or not u.hostname or u.username or u.password:
raise SystemExit("Result URL must be HTTPS without embedded credentials")
owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
raw=subprocess.check_output(args)
ext="wav" if raw.startswith(b"RIFF") and raw[8:12]==b"WAVE" else "flac" if raw.startswith(b"fLaC") else "ogg" if raw.startswith(b"OggS") else "mp3" if raw.startswith(b"ID3") or raw[:1]==b"\xff" else "bin"
f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)
print("Saved",f,clip.get("asset_id"))
PY_RESULT
รับและบันทึกผลลัพธ์
Ailoot · เพลง
คลิปเสียงทั้งหมดที่เป็นของคุณ / ลิงก์ JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด
เก็บทุกการตอบกลับ ไฟล์ และส่วนเนื้อหาที่ส่งกลับมาอย่างครบถ้วน
บันทึก/เรียกคลิปทุกชิ้นที่ส่งกลับ และเก็บ ID, MIME และเมทาดาทาจริงไว้ เมธอดนี้ทำงานแบบซิงโครนัส ไม่มีการเพิ่ม URL ตรวจสอบสถานะการสร้างเพลงของ Ailoot แยกต่างหาก
เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ
หากต้องตรวจสอบผลลัพธ์เพลง ให้เก็บ operation_id/X-Client-Request-ID เดิมและข้อมูลคลิปที่ส่งกลับ กู้คืนคลิปเดิมที่เป็นของคุณผ่านคลังสื่อด้วยค่า task_id หรือ asset_id จริง อย่าส่งคำขอเพลงซ้ำหรือสร้าง URL ตรวจสอบสถานะการสร้างจาก operation_id
ฟิลด์การตอบกลับ
| ฟิลด์ | ประเภท |
|---|---|
ฟิลด์model | ประเภทstring |
ฟิลด์response_id | ประเภทstring |
ฟิลด์data[] | ประเภทowned clip record |
ข้อผิดพลาดและขั้นตอนถัดไป
| การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป |
|---|---|---|
การตอบกลับ400 · invalid_request_error | เงื่อนไขฟิลด์จำเป็น รูปแบบการแทนข้อมูล หรือค่าพารามิเตอร์ไม่ถูกต้อง | ขั้นตอนถัดไปแก้ฟิลด์ที่ระบุก่อนส่งคำขอสร้างครั้งใหม่ |
การตอบกลับserver_error | เงื่อนไขการตอบกลับที่ได้รับระบุว่าต้องตรวจสอบการดำเนินการหรือผลลัพธ์ | ขั้นตอนถัดไปเก็บ ID การดำเนินการ/งานที่ส่งกลับมาแต่เดิม ส่วนหัวของคำขอ และการตอบกลับไว้ แล้วอ่านข้อมูลการดำเนินการเดิมนั้นต่อด้วยวิธีที่รองรับ ห้ามส่งคำขอสร้างซ้ำ |
ชื่ออื่น
ชื่ออื่นของโมเดล
Ailoot google/lyria-3-clip-preview
ชื่อพาธเมธอดอื่น
ใช้พาธเมธอดที่แสดงด้านบน
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · Lyria 3 Clip Preview
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/music/generations·google/lyria-3-clip-preview:text→music- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/music/generations·google/lyria-3-clip-preview:model,prompt