Một khóa, mọi mô hình
28 mô hình ảnh, video và âm thanh chỉ với một REST API và một số dư Gems. Đổi mô hình bằng cách thay đường dẫn URL.
Xem 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.
1
mô hình âm thanh
$0.019
Mặc định rẻ nhất, mỗi clip
20
Lượt tạo đồng thời
$0
Phí hằng tháng
Mô hình
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 |
|---|---|---|---|
| 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 MAGE_API_KEY, gửi yêu cầu rồi thăm dò cho đến khi hoàn tất. Thay seed_audio trong URL bằng bất kỳ mô hình nào ở trên.
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
print(request["result"]["url"])Cách hoạt động
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.
Đă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 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 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
28 mô hình ảnh, video và âm thanh chỉ với một REST API và một số dư Gems. Đổi mô hình bằng cách thay đường dẫn URL.
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.
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.
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ợ.
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ý.
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
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 độ.
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.
Tạo âm thanh môi trường, foley và âm thanh giao diện từ mô tả cho game và ứng dụng.
Tạo nhạc nền cho clip mạng xã hội và quảng cáo từ một prompt.
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.
Để 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ó. Seed Audio đọc kịch bản bằng giọng được mô tả hoặc giọng tham chiếu đã lưu, đồng thời có các tùy chọn tốc độ nói, độ lớn và cao độ. Nó cũng tạo nhạc và hiệu ứng âm thanh từ cùng một ô prompt.
Seed Audio tạo clip dài tới 120 giây.
Không có gói đăng ký hay phí hàng tháng. Mỗi lượt tạo được trả bằng Gems theo giá niêm yết của mô hình, và 1.000 Gems có giá 1 $ với gói tiêu chuẩn. Trang của từng mô hình đều ghi giá theo cài đặt mặc định, và mỗi phản hồi đều cho biết chính xác khoản đã tính. Lượt tạo bị lỗi sẽ được hoàn lại; lượt bị chặn bởi chính sách nội dung của Mage thì không. Yêu cầu vượt quá số dư của bạn sẽ bị từ chối trước khi tính bất kỳ khoản phí nào.
Không. API chỉ chạy bằng Gems. Các gói thành viên và quyền tạo không giới hạn trong ứng dụng không áp dụng cho các yêu cầu API, nên bất kỳ tài khoản Mage nào có Gems đều có thể gọi API.
Có. Bạn có thể dùng nội dung tạo bằng Mage, kể cả qua API và máy chủ MCP, cho mục đích thương mại. Ghi nguồn thì chúng tôi rất trân trọng nhưng không bắt buộc.
Mỗi tài khoản có thể có tối đa 20 lượt tạo đang chờ hoặc đang chạy cùng lúc. Nếu gửi vượt mức này, yêu cầu sẽ bị từ chối với mã 429 và bạn không mất phí. Hãy gửi email tới [email protected] để nâng giới hạn theo nhu cầu của bạn.
Có. Agent có thể gọi REST API bằng khóa API, hoặc kết nối với máy chủ MCP của Mage, nơi cung cấp cho Claude, ChatGPT, Claude Code, Grok và Cursor 16 công cụ dựng sẵn để chọn mô hình, báo giá, tạo nội dung và lấy kết quả. Xem máy chủ MCP.
Có. Gói chính thức @mage-space/sdk trên npm và mage-space trên PyPI đều là mã nguồn mở và có định kiểu cho mọi mô hình. SDK sẽ gửi yêu cầu, chờ kết quả, thử lại an toàn và tải tệp lên giúp bạn. Người dùng ComfyUI có thể cài bộ node comfyui-mage. Xem các SDK của Mage.
Trỏ client của bạn tới https://api.mage.space/v1, gửi khóa Mage dưới dạng Bearer token và ánh xạ các trường theo trang của mô hình: prompt, aspect_ratio, resolution, duration và model_id hoạt động giống nhau trên mọi mô hình của Mage. Yêu cầu được xử lý bất đồng bộ, nên bạn hãy gửi yêu cầu rồi poll status_url.
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.