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 độ.

Lấy khóa APIĐọc tài liệu API
POST https://api.mage.space/v1/{model}/generate

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.

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ìnhPhù hợp nhất choGiá trị model_idGiá mặc định
Seed AudioGiọng nói, nhạc và hiệu ứng âm thanh từ một promptseed-audio-1.019 Gems ($0.019)

Bắt đầu nhanh

Tạo âm thanh với Seed Audio

Đặ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.

cURL
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"
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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.0',
});

console.log(request.result.url);
Python
# 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

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.

  1. 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.

  2. 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.

  3. 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

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.

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?

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.

Âm thanh được tạo có thể dài bao lâu?

Seed Audio tạo clip dài tới 120 giây.

Mage API có giá bao nhiêu?

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.

Tôi có cần gói thành viên Mage để dùng API không?

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.

Tôi có thể dùng kết quả từ API cho mục đích thương mại không?

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.

Giới hạn tốc độ (rate limit) là bao nhiêu?

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.

Agent AI của tôi có dùng được Mage API không?

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.

Mage API có SDK không?

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.

Tôi đang dùng một API tạo nội dung khác. Tôi cần thay đổi những gì?

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.

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.

Lấy khóa APIĐọc tài liệu API

Liên quan