Mage API · Mô hình video
API Plum
Có âm thanh cho mọi clip, lên đến 2K
POST https://api.mage.space/v1/plum/generateXem nhanh
Plum API chạy Plum Fast và 2 biến thể khác qua Mage tại POST https://api.mage.space/v1/plum/generate. Một yêu cầu với cài đặt mặc định tốn 173 Gems (khoảng 0,173 $), không cần đăng ký gói. Plum nhận nhân vật, tham chiếu và tham chiếu âm thanh đã lưu thông qua @handle trong prompt.
- VideoĐầu ra
- 3Biến thể
- 173Gems mỗi clip, mặc định
- $0.173Khoảng, tính bằng USD
Tổng quan
Plum API làm được gì
Video đầy đủ tính năng với âm thanh trên mọi clip và đầu ra lên đến 2K. Hỗ trợ khung hình đầu và cuối, tối đa 9 tham chiếu hoặc Characters, cùng Voices; dài từ 4 đến 15 giây.
Mô hình video đầy đủ tính năng của Mage, có âm thanh được tạo cho mọi clip và đầu ra đến 2K, gồm Plum, Plum Max nhanh hơn, và Plum Fast, nhanh nhất và giá thấp nhất.
Nhận first_image, last_image, image, additional_images, videos làm đầu vào.
Bắt đầu nhanh
Gọi Plum API
Đặt MAGE_API_KEY, gửi yêu cầu đến /plum/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/plum/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": "5",
"model_id": "plum-fast"
}' | 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('plum', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'plum-fast',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("plum", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "plum-fast",
})
print(request["result"]["url"])Mô hình
Giá trị model_id của Plum
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 |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Có |
Tùy chọn
Tham số của Plum
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ị |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Đầu vào
Đầu vào media mà Plum chấp nhận
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ò |
|---|---|
| first_image | Ảnh khung hình đầu tiên. |
| last_image | Ảnh khung hình cuối. |
| 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 quy tắc Plum API áp dụng
- Không thể kết hợp khung hình đầu và cuối với ảnh tham chiếu: chỉ gửi một loại.
- Với `plum-max` và `plum-fast`, khung hình cuối phải đi kèm khung hình đầu.
- Chỉnh sửa video yêu cầu đúng một video nguồn dài 2 đến 15 giây, một `duration` đầu ra và tối đa 2 ảnh tham chiếu, tính cả nhân vật và tham chiếu được nhắc đến. Không dùng khung hình, tham chiếu âm thanh hay giọng nhân vật: hãy gửi `use_character_voices: false` để nhắc đến nhân vật có giọng nói.
- Với `plum-max`, video nguồn được tính phí theo giây cao hơn video đầu ra, nên ở 768P, chỉnh sửa trên `plum-max` tốn kém hơn trên `plum`.
Thêm mô hình video
Các API tạo video khác trên Mage
Raspberry API
Nhân vật sống động từ khung hình đầu tiên
Seedance API
Seedance, với bộ lọc nghiêm ngặt
Wan 3.0 API
Wan 3.0, với bộ lọc nghiêm ngặt
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
Blueberry API
Cố định khung hình đầu và cuối
FAQ
Câu hỏi thường gặp
Plum API có giá bao nhiêu?
Endpoint của Plum API là gì?
Tôi có thể gọi những mô hình Plum nào?
Plum có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Tôi có thể dùng Plum từ Claude hoặc ChatGPT không?
Kết quả của Plum đượ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.