Mage API · Tạo video
API tạo video AI từ văn bản hoặc ảnh
Chuyển văn bản thành video, ảnh thành video, khung hình đầu và cuối, và tham chiếu thành video từ 15 mô hình, dẫn đầu là Cherry 2 Pro, mô hình chủ lực của Mage, với âm thanh cho nhiều clip.
POST https://api.mage.space/v1/{model}/generateXem nhanh
API tạo video của Mage là một REST API tại https://api.mage.space/v1 chạy 15 mô hình chuyển văn bản thành video và ả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 tham chiếu tùy chọn, kiểm tra trạng thái yêu cầu, rồi tải về file MP4. Mỗi clip được trả phí bằng Gems theo mô hình, độ phân giải và thời lượng.
- 15model video
- $0.02Mặc định rẻ nhất, mỗi clip
- 20Lượt tạo đồng thời
- $0Phí hằng tháng
Mô hình
Tất cả model video 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ì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, 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) |
| Magejutsu | Tái tạo mọi video, giữ nguyên chuyển động | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| 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, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Có âm thanh cho mọi clip, lên đến 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Nhân vật sống động từ khung hình đầu tiên | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, có bộ lọc nghiêm ngặt | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, có bộ lọc nghiêm ngặt | wan-3.0 | 245 Gems ($0.245) |
| 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ạo video với Berry 2
Đặ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.
cURL
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"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('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);Python
# 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
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.
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í.
Trường hợp sử dụng
Nhà phát triển xây dựng gì với API video
Video ngắn và mạng xã hội
Tạo clip dọc cho TikTok, Reels và Shorts từ một prompt hoặc ảnh sản phẩm.
Làm ảnh tĩnh chuyển động
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.
Câu chuyện xoay quanh nhân vật
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.
Video có âm thanh
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.
Quảng cáo và demo sản phẩm
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.
Chỉnh sửa clip có sẵ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
Câu hỏi thường gặp
API tạo video AI nào tốt nhất?
API video có hỗ trợ từ ảnh thành video không?
Video tạo ra có thể dài bao lâu?
Tạo một video mất bao lâu?
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.