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
Mage cung cấp cho nhà phát triển một REST API tại https://api.mage.space/v1 và một MCP server từ xa tại https://mcp.mage.space/mcp. Cả hai đều chạy cùng 28 mô hình tạo ảnh, video và âm thanh, gồm Mango 3 và Cherry 2 Pro độc quyền của Mage, trên một tài khoản duy nhất. Mỗi lượt tạo được trả bằng Gems, không cần đăng ký gói.
28
Mô hình
3
Loại phương tiện
16
Công cụ MCP
$0
Phí hằng tháng
Các cách bắt đầu
Gọi từ code, trợ lý AI hoặc ComfyUI
REST API
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
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.
MCP server
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.
ComfyUI
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
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-v3"
}' | 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-v3',
});
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-v3",
})
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
Ảnh · từ 40 Gems
Flux 2 API
Prompt dài và chỉnh sửa với nhiều ảnh tham chiếu
Ảnh · từ 9 Gems
GPT Image 2 API
Prompt chính xác và chữ dễ đọc
Ảnh · từ 37 Gems
Guava API
Chân thực đến mức như ảnh chụp thật
Ảnh · từ 135 Gems
Mango API
Dòng mô hình ảnh chủ lực của chúng tôi
Ảnh · từ 68 Gems
Nano Banana 2 API
Chữ sắc nét, dễ đọc, lên đến 4K
Video · từ 618 Gems
Cherry API
Dòng mô hình video chủ lực của chúng tôi
Video · từ 245 Gems
Lemon API
Đủ mọi tính năng video, với mức giá dễ chịu hơn
Video · từ 338 Gems
Plum API
Có âm thanh cho mọi clip, lên đến 2K
Âm thanh · từ 19 Gems
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
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ì?
Mage API là một REST API tại https://api.mage.space/v1 để tạo ảnh, video và âm thanh với 28 mô hình ngay từ code của bạn. Các yêu cầu được xử lý bất đồng bộ và tính phí theo từng lượt tạo bằng Gems.
Máy chủ Mage MCP là gì?
Đây là một máy chủ Model Context Protocol từ xa tại https://mcp.mage.space/mcp, cho phép các trợ lý AI tạo ảnh, video và âm thanh trên tài khoản Mage của bạn. Trợ lý sẽ có 16 công cụ để chọn mô hình, báo giá, tạo nội dung, chờ kết quả và dùng các nhân vật, ảnh tham chiếu và lịch sử bạn đã lưu.
Tôi có cần khóa API để dùng máy chủ MCP không?
Không. Claude, ChatGPT, Grok, Cursor và Claude Code kết nối bằng cách đăng nhập vào Mage qua OAuth. Khóa API là tùy chọn, dành cho các thiết lập không giao diện như CI.
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.