Lyria
Sinh nhạc từ chữ, yêu cầu một đến tám clip, nhận kết quả đồng bộ.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
google/lyria tạo nhạc từ prompt chữ qua /v1/music/generations. Ví dụ: nhạc không lời tiết chế cho demo sản phẩm, mô tả nhạc cụ nổi bật và khoảng trống cần cho lời dẫn. Chọn khi kết quả mong muốn là clip nhạc sinh.
Yêu cầu cần model, prompt. n hoặc count nhận một đến tám clip; phương thức trả kết quả đồng bộ. Lưu mọi clip trả và metadata thật. Không có đầu vào âm thanh tham chiếu, thiết lập thời lượng hay trường tempo nên không phải điều khiển chọn độc lập. Mô tả ý đồ âm nhạc trong prompt, không coi là thuộc tính đo được được bảo đảm.
Ailoot · Âm nhạc POST /v1/music/generations google/lyria
google/lyriaBắt đầu
Sinh nhạc từ chữ, yêu cầu một đến tám clip, nhận kết quả đồng bộ.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- music
Có trên Ailoot · đầu vào & phương thức
Ailoot · Âm nhạc POST /v1/music/generations
- Đầu vào
text- Đầu ra
music- Định dạng đầu ra
- các đoạn âm thanh hoàn chỉnh thuộc quyền sở hữu / liên kết JSON
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn google/lyria | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 8 | Mặc định1 |
Trườngcount | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 8 Điều kiện: Nếu cũng cung cấp n, count phải khớp | Mặc định— |
Tổ hợp tư liệu đầu vào
text_to_music · Bắt buộc: prompt
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốmaterial_types | Hợp đồngtext |
Tham sốrequired | Hợp đồngnull |
Tham sốoptional_controls | Hợp đồngnull |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cấu trúc phương thức và ID là chính xác; khả năng của nhà cung cấp tách biệt với việc cho phép tiếp nhận yêu cầu.
Bảng giá
Mức phí phương thức Ailoot
POST /v1/music/generations- Đầu ra
- 0,08 US$ mỗi đoạn
- Chỉ tham chiếu · không cộng thêm
- 0,08 US$ mỗi yêu cầu
Số đoạn đã giao × giá cơ bản mỗi đoạn. Không cộng thêm giá tham chiếu mỗi yêu cầu. Ví dụ trước các điều chỉnh áp dụng.
1 × 0,08 US$ = 0,08 US$
4 × 0,08 US$ = 0,32 US$
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot · Âm nhạc
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", "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
Nhận và lưu kết quả
Ailoot · Âm nhạc
các đoạn âm thanh hoàn chỉnh thuộc quyền sở hữu / liên kết JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lưu tất cả kết quả đã hoàn tất
Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
Lưu/truy xuất mọi đoạn âm thanh được trả về và giữ nguyên ID, MIME cùng siêu dữ liệu thực tế. Phương thức hoạt động đồng bộ; không bổ sung URL thăm dò riêng cho việc tạo nhạc của Ailoot.
Nếu cần kiểm tra phản hồi gốc
Nếu kết quả nhạc cần được kiểm tra, giữ nguyên operation_id/X-Client-Request-ID ban đầu và thông tin đoạn âm thanh được trả về. Khôi phục các đoạn âm thanh hiện có thuộc quyền sở hữu qua thư viện đa phương tiện bằng các giá trị task_id hoặc asset_id thực tế. Không gửi lại yêu cầu nhạc hoặc dựng URL thăm dò tạo nhạc từ operation_id.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngmodel | Loạistring |
Trườngresponse_id | Loạistring |
Trườngdata[] | Loạiowned clip record |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |
Phản hồiserver_error | Điều kiệnPhản hồi trả về cho biết thao tác hoặc kết quả cần được kiểm tra | Bước tiếp theoGiữ lại ID thao tác/tác vụ gốc đã trả về, các header của yêu cầu và toàn bộ phản hồi; tiếp tục truy xuất thao tác gốc đó bằng các phương thức được hỗ trợ. Không gửi lại yêu cầu tạo. |
Bí danh
Bí danh mô hình
Ailoot google/lyria
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Lyria
- Có những đầu vào và kết quả nào?
POST /v1/music/generations·google/lyria:text→music- Yêu cầu sử dụng những trường nào?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Áp dụng những giới hạn nào?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8