Chuyển đến nội dung

Mage API · Mô hình âm thanh

Eleven Music API

Bài hát ElevenLabs, có hoặc không có giọng hát

POST https://api.mage.space/v1/eleven_music/generate

Xem nhanh

Eleven Music API chạy Eleven Music v2.5 qua Mage tại POST https://api.mage.space/v1/eleven_music/generate. Một yêu cầu với cài đặt mặc định tốn 113 Gems (khoảng $0.113), không cần đăng ký gói. Eleven Music không hỗ trợ nhắc @handle.

  • Âm thanhĐầu ra
  • 1Biến thể
  • 113Gems mỗi clip, mặc định
  • $0.113Khoảng, tính bằng USD

Tổng quan

Eleven Music API làm được gì

Eleven Music của ElevenLabs: tạo bài hát có lời và giọng hát, hoặc nhạc không lời, từ một mô tả, với độ dài chính xác bạn chọn, tối đa 5 phút.

Mô hình nhạc của ElevenLabs: bài hát có lời hoặc nhạc không lời, xuất dạng MP3 có thời lượng đúng như yêu cầu. Prompt nêu tên nghệ sĩ hoặc trích lời bài hát có bản quyền sẽ bị ElevenLabs từ chối; yêu cầu sẽ thất bại và được hoàn tiền.

Mô hình chỉ tạo ảnh từ prompt.

Bắt đầu nhanh

Gọi Eleven Music API

Đặt MAGE_API_KEY, gửi đến /eleven_music/generate rồi poll status_url cho đến khi yêu cầu hoàn tất.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
  "duration": "30",
  "model_id": "eleven-music-v2.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('eleven_music', {
  prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
  duration: '30',
  model_id: 'eleven-music-v2.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("eleven_music", {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
    "duration": "30",
    "model_id": "eleven-music-v2.5",
})

print(request["result"]["url"])

Mô hình

Giá trị model_id của Eleven Music

Gửi model_id để chọn phiên bản. Yêu cầu không có model_id sẽ chạy phiên bản mặc định.

model_idTênMặc định
eleven-music-v2.5Eleven Music v2.5Có

Tùy chọn

Tham số của Eleven Music

Các giá trị được phép trên tất cả phiên bản; mỗi phiên bản có thể hỗ trợ ít hơn. Tài liệu liệt kê các tùy chọn theo từng phiên bản.

TrườngGiá trị
duration10, 30, 60, 120, 180, 300

Quy tắc

Eleven Music API áp dụng những giới hạn nào

  • Prompt mô tả bài hát, tối đa 2000 ký tự.

Thêm mô hình âm thanh

Các API tạo âm thanh khác trên Mage

  • Âm thanh · từ 30 Gems

    Eleven Speech API

    ElevenLabs v4: giọng nói chân thực, bạn tự điều chỉnh được

  • Âm thanh · từ 19 Gems

    Seed Audio API

    Giọng nói, nhạc và hiệu ứng âm thanh từ một prompt

FAQ

Câu hỏi thường gặp

Eleven Music API có giá bao nhiêu?
Một yêu cầu Eleven Music với cài đặt mặc định (Eleven Music v2.5) tốn 113 Gems, khoảng $0.113. Độ phân giải, thời lượng và biến thể khác sẽ làm giá thay đổi; phản hồi sẽ cho biết chính xác khoản bị tính. Lượt tạo thất bại được hoàn tiền; lượt bị chính sách nội dung của Mage chặn thì không.
Endpoint của Eleven Music API là gì?
POST https://api.mage.space/v1/eleven_music/generate kèm header Authorization: Bearer chứa khóa API Mage của bạn. Phản hồi có status_url để bạn poll lấy kết quả.
Tôi có thể gọi những mô hình Eleven Music nào?
eleven-music-v2.5 (Eleven Music v2.5). Mặc định là Eleven Music v2.5.
Eleven Music có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Eleven Music không nhận đầu vào ảnh, video hay âm thanh. Eleven Music không hỗ trợ nhắc @handle.
Tôi có thể dùng Eleven Music từ Claude hoặc ChatGPT không?
Có. Kết nối máy chủ Mage MCP với Claude, ChatGPT, Claude Code, Grok hoặc Cursor và yêu cầu Eleven Music theo tên. Trợ lý của bạn đọc các tùy chọn của mô hình bằng get_model và báo giá trước khi tạo.
Kết quả của Eleven Music được lưu trong bao lâu?
Kết quả và đầu vào được lưu trong 30 ngày. Hãy tải về bộ nhớ của bạn bất cứ thứ gì bạn muốn giữ lại.

Bắt đầu xây dựng với Mage

Một tài khoản, một số dư Gems, mọi mô hình. Bạn chỉ trả tiền cho những gì mình tạo.