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 video của Mage là một REST API tại https://api.mage.space/v1, chạy 12 model từ văn bản thành video và từ ảnh thành video, gồm Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video và Wan. Bạn gửi prompt cùng khung hình hoặc ảnh tham chiếu (tùy chọn), thăm dò trạng thái yêu cầu rồi tải về tệp MP4. Mỗi clip được trả bằng Gems theo model, độ phân giải và thời lượng.
12
model video
$0.02
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 |
|---|---|---|---|
| Berry | Video bám sát ảnh tham chiếu của bạn | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Cố định khung hình đầu và cuối | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Dòng video chủ lực của chúng tôi | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, chuyển động | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video hằng ngày, không cần thiết lập | kiwi | 270 Gems ($0.27) |
| Lemon | Đủ mọi tính năng video, giá dễ chịu hơn | lemon | 245 Gems ($0.245) |
| LTX Video | Video open-weights nhanh để thử lặp | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime chuyển động, có thể kèm âm thanh | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Video mã nguồn mở nhanh với âm thanh stereo | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Có âm thanh cho mọi clip, lên đến 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Nhân vật sống động từ khung hình đầu tiên | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Video open-weights với phiên bản Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
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 berry trong URL bằng bất kỳ model nào ở trên.
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
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 clip dọc cho TikTok, Reels và Shorts từ một prompt hoặc ảnh sản phẩm.
Biến một khung hình đầu, hoặc khung hình đầu và cuối, thành chuyển động với các model từ ảnh thành video như Lemon và Kiwi.
Giữ cùng một nhân vật qua các cảnh quay với các model từ ảnh tham chiếu thành video hỗ trợ nhân vật dạng @handle.
Plum và một số model khác tạo giọng nói, hiệu ứng âm thanh và âm thanh nền cùng với hình ảnh, đồng thời nhận âm thanh tham chiếu cho giọng nói.
Tạo nhiều biến thể của một quảng cáo rồi chọn bản thắng, với cơ chế gửi idempotent không bao giờ tính phí hai lần.
Berry, Plum và Grok Video chỉnh sửa video gốc bạn gửi lên; Lemon và MiniMax-H3 còn nhận cả video tham chiếu.
FAQ
Trên Mage, Cherry 2 Pro là lựa chọn mặc định cho video: hỗ trợ nhân vật, nhiều ảnh tham chiếu, âm thanh tham chiếu, đầu ra từ 480p đến 1080p và clip dài đến 30 giây. Lemon phù hợp khi cần kiểm soát khung hình đầu và cuối, Plum cho clip có âm thanh tạo kèm đến 2K, còn Cherry Mini hoặc Wan cho bản nháp rẻ hơn.
Có. Các model từ ảnh thành video nhận một khung hình đầu, một số còn nhận khung hình cuối hoặc ảnh tham chiếu, dưới dạng URL, data URL hoặc tệp tải lên. Trang của từng model liệt kê các đầu vào và việc có bắt buộc phải có ảnh hay không.
Tùy theo model và độ phân giải. Nhiều model tạo video dài từ 4 đến 15 giây, còn Cherry 2 Pro đạt 20, 25 và 30 giây. Trang của từng model liệt kê các thời lượng hỗ trợ.
Tùy theo model, độ phân giải và thời lượng. API hoạt động bất đồng bộ: bạn gửi yêu cầu, sau đó thăm dò status_url với backoff, hoặc để MCP client của bạn chờ bằng get_request.
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.