Mage API · Dành cho ý tưởng tiếp theo của bạn
Một API. Khả năng vô tận.
Đưa những điều tốt nhất của Mage vào sản phẩm và trợ lý AI của bạn. Tạo ảnh, video và âm thanh chỉ với một khóa API hoặc một kết nối MCP.
https://api.mage.space/v1Xem nhanh
Mage cung cấp cho nhà phát triển một REST API tại https://api.mage.space/v1 và một máy chủ MCP từ xa tại https://mcp.mage.space/mcp. Cả hai đều chạy cùng 37 mô hình ảnh, video và âm thanh, gồm Mango 4 và Cherry 2 Pro độc quyền của Mage, trên một tài khoản, và mỗi lần tạo đều trả bằng Gems, không cần đăng ký gói.
- 37Mô hình
- 3Loại phương tiện
- 16Công cụ MCP
- $0Phí hằng tháng
Các cách bắt đầu
Gọi từ code, trợ lý AI hoặc ComfyUI
Mage API
Gửi yêu cầu tạo từ code của bạn bằng một khóa. Hỗ trợ yêu cầu bất đồng bộ, thử lại idempotent, tải lên tối đa 100 MB và 20 lượt tạo chạy cùng lúc.
SDK TypeScript và Python
Các client chính thức, có định kiểu, giúp gửi yêu cầu, chờ kết quả, thử lại an toàn và tải tệp lên chỉ với vài dòng.
Mage MCP server
Kết nối Claude, ChatGPT, Claude Code, Grok hoặc Cursor chỉ bằng đăng nhập, rồi yêu cầu tạo ảnh, video và âm thanh bằng lời nói thông thường.
Mage cho ComfyUI
Mango, Cherry, Seed Audio và mọi mô hình khác của Mage dưới dạng node ComfyUI. Không cần GPU, không cần tải mô hình.
Theo loại phương tiện
API tạo nội dung
API AI tạo ảnh
Tạo ảnh từ văn bản, chỉnh sửa và nhân vật nhất quán lên đến 4K.
API AI tạo video
Tạo video từ văn bản, từ ảnh, khung hình, tham chiếu và âm thanh.
API AI tạo âm thanh
Giọng nói, lời dẫn, nhạc và hiệu ứng âm thanh từ một prompt.
Bắt đầu nhanh
Lượt tạo đầu tiên của bạn
Tạo khóa trong API → API Keys, xuất nó thành MAGE_API_KEY rồi chạy một trong các đoạn sau.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
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.
MCP
Mage trong trợ lý AI của bạn
Mage trong Claude
Tạo ảnh, video và âm thanh trong Claude trên web, ứng dụng máy tính, ứng dụng di động và Cowork.
Mage trong ChatGPT
Tạo ảnh, video và âm thanh trong ChatGPT dưới dạng ứng dụng MCP cá nhân.
Mage trong Claude Code
Tạo ảnh, video và âm thanh ngay trong Claude Code, ngay trên terminal và trình soạn thảo của bạn.
Mage trong Grok
Tạo ảnh, video và âm thanh trong Grok thông qua trình kết nối tùy chỉnh.
Mage trong Cursor
Tạo ảnh, video và âm thanh trong chế độ Agent của Cursor.
Mô hình
Mô hình nổi bật
Flux 2 API
Prompt dài và chỉnh sửa với nhiều ảnh tham chiếu
GPT Image 2 API
Prompt chính xác và chữ dễ đọc
Guava API
Chân thực đến mức như ảnh chụp thật
Mango API
Dòng mô hình ảnh chủ lực của chúng tôi
Nano Banana 2 API
Chữ sắc nét, dễ đọc, lên đến 4K
Cherry API
Dòng mô hình video chủ lực của chúng tôi
Lemon API
Đủ mọi tính năng video, với mức giá dễ chịu hơn
Plum API
Có âm thanh cho mọi clip, lên đến 2K
Seed Audio API
Giọng nói, nhạc và hiệu ứng âm thanh từ một prompt
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í.
FAQ
Câu hỏi thường gặp
Mage API là gì?
Máy chủ Mage MCP là gì?
Tôi có cần khóa API để dùng máy chủ MCP không?
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.