Mage API · Mô hình video
Magejutsu API
Tái tạo mọi video, giữ nguyên chuyển động
POST https://api.mage.space/v1/magejutsu/generateXem nhanh
Magejutsu API chạy Magejutsu và 2 biến thể khác thông qua Mage tại POST https://api.mage.space/v1/magejutsu/generate. Một yêu cầu với cài đặt mặc định có giá 1,856 Gems (khoảng $1.856), không cần đăng ký gói. Magejutsu hỗ trợ nhân vật đã lưu và tham chiếu bằng @handle trong prompt.
- VideoĐầu ra
- 3Biến thể
- 1,856Gems mỗi clip, mặc định
- $1.856Khoảng, tính bằng USD
Tổng quan
Magejutsu API làm được gì
Tái tạo một video bạn đã có: gửi clip cùng ảnh của người hoặc vật sẽ thay thế, còn chuyển động, góc máy, nhịp độ và âm thanh vẫn giữ nguyên như đã quay. Video gốc dài từ 4 đến 30 giây.
Tái tạo một video có sẵn: một đạo diễn viết prompt chỉnh sửa dựa trên video gốc, rồi bước chỉnh sửa video dựng lại người và vật xuất hiện. Gửi video gốc và các tham chiếu thay thế; kết quả giữ nguyên độ dài, tỷ lệ, chuyển động và âm thanh của bản gốc.
Đầu vào gồm image, additional_images, videos.
Bắt đầu nhanh
Gọi Magejutsu API
Đặt MAGE_API_KEY, gửi yêu cầu đến /magejutsu/generate và kiểm tra status_url cho đến khi yêu cầu hoàn tất.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
"videos": [
"https://example.com/input.jpg"
],
"image": "https://example.com/input.jpg",
"model_id": "magejutsu"
}' | 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('magejutsu', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
videos: [
'https://example.com/input.jpg',
],
image: 'https://example.com/input.jpg',
model_id: 'magejutsu',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("magejutsu", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"videos": [
"https://example.com/input.jpg",
],
"image": "https://example.com/input.jpg",
"model_id": "magejutsu",
})
print(request["result"]["url"])Mô hình
Giá trị model_id của Magejutsu
Gửi model_id để chọn phiên bản. Yêu cầu không có model_id sẽ chạy phiên bản mặc định.
| model_id | Tên | Mặc định |
|---|---|---|
| magejutsu | Magejutsu | Có |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
Tùy chọn
Tham số của Magejutsu
Các giá trị được phép trên tất cả phiên bản; mỗi phiên bản có thể hỗ trợ ít hơn. Tài liệu liệt kê các tùy chọn theo từng phiên bản.
| Trường | Giá trị |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
Đầu vào
Đầu vào media mà Magejutsu hỗ trợ
Gửi mỗi tệp dưới dạng URL https, data URL hoặc tải lên tối đa 100 MB.
| Trường | Vai trò |
|---|---|
| image | Ảnh tham chiếu. |
| additional_images | Các ảnh tham chiếu bổ sung. |
| videos | Các video nguồn. |
Quy tắc
Các giới hạn của Magejutsu API
- Video nguồn dài từ 4 đến 30 giây trên magejutsu, và từ 4 đến 15 giây trên magejutsu-lite, biến thể nhanh hơn và rẻ hơn, cũng như trên magejutsu-feather, biến thể rẻ nhất và nhanh nhất, chỉ chạy motion_transfer và render ở 480p và 720p. Video đầu ra giữ nguyên độ dài và tỷ lệ khung hình của video nguồn.
- Mọi yêu cầu đều chạy qua cùng một "đạo diễn" ở phía backend. Chọn motion_transfer để dựng lại diễn viên nhưng giữ nguyên chuyển động, hoặc object_swap để thay đổi các thành phần đã chọn và giữ nguyên phần còn lại của cảnh quay gốc. Chế độ này cũng quyết định cách chuẩn bị nguồn: với motion transfer, quá trình chỉnh sửa được dẫn hướng bằng chuyển động và khuôn mặt của từng diễn viên được thay thế, còn với object swap, nguồn được chỉnh sửa đúng như khi quay. Nếu clip không đọc được phần dẫn hướng, chẳng hạn clip không có người, hệ thống sẽ dựng từ nguồn như khi quay. Không có bước duyệt thủ công hay bản dựng nháp nào.
- Gửi tối đa 30 ảnh tham chiếu qua image và additional_images. Director đọc tất cả, còn bản chỉnh sửa chỉ nhận những ảnh mà prompt dùng đến: tối đa 27 ảnh với magejutsu, 9 với magejutsu-lite và 8 với magejutsu-feather.
- Prompt là tùy chọn: nếu không có, đạo diễn sẽ ghép các ảnh tham chiếu với nguồn dựa trên mức độ nổi bật và độ phù hợp.
- Theo mặc định, âm thanh gốc sẽ được khôi phục; đặt keep_original_audio thành false để giữ lại âm thanh đã tạo.
- Các ảnh là phần thay thế; hãy nhắc đến từng ảnh trong prompt theo vị trí ("ảnh 1 là người bên trái").
- Mỗi yêu cầu chỉ nhận một video gốc; clip dài hơn sẽ bị từ chối chứ không được cắt bớt.
Thêm mô hình video
Các API tạo video khác trên Mage
Melon API
Anime chuyển động, có thể kèm âm thanh
MiniMax-H3 API
Video mã nguồn mở nhanh, có âm thanh stereo
Plum API
Có âm thanh cho mọi clip, lên đến 2K
Raspberry API
Nhân vật sống động từ khung hình đầu tiên
Wan Video v2.2 API
Video open-weights có thêm biến thể Lightning
Berry API
Video bám sát các tham chiếu của bạn
FAQ
Câu hỏi thường gặp
Magejutsu API có giá bao nhiêu?
Endpoint của Magejutsu API là gì?
Tôi có thể gọi những mô hình Magejutsu nào?
Magejutsu có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Tôi có thể dùng Magejutsu từ Claude hoặc ChatGPT không?
Kết quả của Magejutsu được lưu trong bao lâu?
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.