Mage API · Tạo âm thanh
API tạo âm thanh bằng AI cho giọng nói, nhạc và hiệu ứng
Giọng đọc, lời dẫn, nhạc và hiệu ứng âm thanh từ một prompt với Seed Audio, kèm giọng tham chiếu và các tùy chọn tốc độ nói, độ lớn và cao độ.
POST https://api.mage.space/v1/{model}/generateXem nhanh
API tạo âm thanh của Mage chạy Seed Audio tại https://api.mage.space/v1/seed_audio/generate. Bạn gửi một prompt văn bản, có thể kèm giọng tham chiếu hoặc hình ảnh, và nhận về tệp âm thanh dài tới 120 giây với giọng nói, nhạc hoặc hiệu ứng âm thanh. Mỗi clip được trả bằng Gems, không cần đăng ký gói.
- 4mô hình âm thanh
- $0.019Mặc định rẻ nhất, mỗi clip
- 20Lượt tạo đồng thời
- $0Phí hằng tháng
Mô hình
Tất cả mô hình âm thanh trong Mage API
Giá tính theo từng lượt tạo, bằng Gems. 1.000 Gems có giá 1 $ với gói tiêu chuẩn, và các gói lớn hơn được tặng thêm Gems. Giá phụ thuộc vào mô hình, độ phân giải và thời lượng; bảng này hiển thị giá ở cài đặt mặc định, còn mỗi phản hồi đều ghi rõ mức phí chính xác trong billing.gems_charged. Lượt tạo bị lỗi sẽ được hoàn Gems; lượt bị chính sách nội dung của Mage chặn thì không.
| Mô hình | Phù hợp nhất cho | Giá trị model_id | Giá mặc định |
|---|---|---|---|
| Eleven Music | Bài hát ElevenLabs, có hoặc không có giọng hát | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: giọng nói chân thực, bạn tự điều chỉnh được | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Bài hát hoàn chỉnh từ lời của bạn, trọng số mở | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Giọng nói, nhạc và hiệu ứng âm thanh từ một prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Bắt đầu nhanh
Tạo âm thanh với Eleven Music v2.5
Đặt MAGE_API_KEY, gửi yêu cầu rồi poll cho đến khi hoàn tất. Thay eleven_music trong URL bằng bất kỳ mô hình nào ở trên.
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"])Cách hoạt động
Từ khóa API đến thành phẩm chỉ với ba lệnh gọi
Mọi mô hình đều dùng chung một cơ chế xác thực, một vòng đời yêu cầu bất đồng bộ và cùng tên trường.
Tạo khóa API
Đăng nhập Mage, mở API → API Keys và tạo một khóa. Khóa bắt đầu bằng mage_sk_ và chỉ hiển thị một lần. Mỗi tài khoản có thể có 10 khóa đang hoạt động.
Gửi yêu cầu tạo
Gửi POST một nội dung JSON đến https://api.mage.space/v1/{model}/generate kèm header Authorization: Bearer. Phản hồi trả về ngay với request_id, status và status_url. Hãy gửi header Idempotency-Key để thử lại không bao giờ bị tính phí hai lần.
Kiểm tra và tải về
Kiểm tra status_url cho đến khi trạng thái là completed, failed hoặc cancelled. Yêu cầu hoàn tất sẽ có result.url chứa tệp ảnh, video hoặc âm thanh, được lưu trong 30 ngày.
Sẵn sàng cho production
Mỗi yêu cầu Mage API đều nhận được
Một khóa, mọi mô hình
37 mô hình ảnh, video và âm thanh dùng chung một REST API và một số dư Gems. Đổi mô hình bằng cách đổi đường dẫn URL.
Trả tiền theo mỗi lần tạo
Không cần đăng ký gói và không có mức chi tối thiểu. Bạn mua Gems, và mỗi yêu cầu sẽ bị tính theo giá niêm yết. Lượt tạo bị lỗi sẽ được hoàn lại, trừ khi bị chặn bởi chính sách nội dung của Mage.
Thử lại an toàn
Khóa idempotency giúp yêu cầu gửi lại trả về kết quả của yêu cầu ban đầu mà không bị tính phí lần nữa.
Nhân vật nhất quán
Chỉ cần lưu nhân vật hoặc ảnh tham chiếu một lần, rồi viết @handle trong bất kỳ prompt nào để dùng với mọi mô hình hỗ trợ.
Dữ liệu đầu vào lớn
Gửi ảnh, video và âm thanh đầu vào dưới dạng URL hoặc data URL, hoặc tải lên tệp tối đa 100 MB qua liên kết tải lên có chữ ký.
20 lượt tạo cùng lúc
Mỗi tài khoản có thể chạy 20 lượt tạo cùng lúc, và giới hạn này có thể được nâng lên theo nhu cầu của bạn. Yêu cầu bị từ chối sẽ không bao giờ bị tính phí.
Trường hợp sử dụng
Nhà phát triển xây dựng gì với API âm thanh
Lời dẫn và lồng tiếng
Tạo lời dẫn cho video, video giải thích và sách nói, với các tùy chọn tốc độ nói, độ lớn và cao độ.
Giọng nói nhất quán
Lưu một đoạn giọng nói làm tham chiếu và nhắc đến bằng @handle để giữ nguyên một giọng trong nhiều clip.
Hiệu ứng âm thanh
Tạo âm thanh môi trường, foley và âm thanh giao diện từ mô tả cho game và ứng dụng.
Nhạc nền
Tạo nhạc nền cho clip mạng xã hội và quảng cáo từ một prompt.
Nhạc phim cho video được tạo
Kết hợp Seed Audio với API video để thêm âm thanh cho các clip từ mô hình không có tiếng.
Agent biết nói
Để Claude, ChatGPT hoặc agent của riêng bạn tạo âm thanh qua máy chủ MCP hoặc REST API.
FAQ
Câu hỏi thường gặp
API âm thanh có chuyển văn bản thành giọng nói được không?
Âm thanh được tạo có thể dài bao lâu?
Mage API có giá bao nhiêu?
Tôi có cần gói thành viên Mage để dùng API không?
Tôi có thể dùng kết quả từ API cho mục đích thương mại không?
Giới hạn tốc độ (rate limit) là bao nhiêu?
Agent AI của tôi có dùng được Mage API không?
Mage API có SDK không?
Tôi đang dùng một API tạo nội dung khác. Tôi cần thay đổi những gì?
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.