Mage API · Mô hình video
Cherry API
Dòng model video hàng đầu của chúng tôi
POST https://api.mage.space/v1/cherry/generateXem nhanh
Cherry API chạy Cherry 2 Pro và 4 biến thể khác qua Mage tại POST https://api.mage.space/v1/cherry/generate. Một yêu cầu với cài đặt mặc định tốn 618 Gems (khoảng $0.618), không cần đăng ký gói. Cherry nhận nhân vật đã lưu, ảnh tham chiếu và âm thanh tham chiếu bằng @handle trong prompt.
- VideoĐầu ra
- 5Biến thể
- 618Gems mỗi clip, mặc định
- $0.618Khoảng, tính bằng USD
Tổng quan
Cherry API làm được gì
Video điện ảnh có âm thanh, từ Cherry Mini để làm bản nháp đến Cherry 2 Pro, model mạnh nhất của chúng tôi, với clip dài tới 30 giây, nhiều tham chiếu hoặc Characters, và chỉnh sửa từ video nguồn.
Dòng video hàng đầu của Mage, với chuyển động điện ảnh và âm thanh: Cherry Mini, Cherry, Cherry Pro, Cherry 2 và Cherry 2 Pro, mạnh nhất. Các mô hình Cherry 2 tạo clip dài tới 30 giây.
Đầu vào gồm image, additional_images, videos.
Bắt đầu nhanh
Gọi Cherry API
Đặt MAGE_API_KEY, gửi yêu cầu tới /cherry/generate và thăm dò status_url cho đến khi yêu cầu hoàn tất.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "4",
"model_id": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])Mô hình
Giá trị model_id của Cherry
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 |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | Có |
Tùy chọn
Tham số của Cherry
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 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Đầu vào
Đầu vào media mà Cherry 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ò |
|---|---|
| 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 Cherry API áp dụng
- Chỉnh sửa video nhận đúng một video nguồn, dài 4 đến 30 giây với `cherry-2` và `cherry-2-pro`, và 2 đến 15 giây với các mô hình còn lại.
- Với `cherry-2` và `cherry-2-pro`, video sau chỉnh sửa giữ nguyên độ dài và tỷ lệ khung hình của video nguồn: `duration` và `aspect_ratio` sẽ bị bỏ qua, và giá tính theo độ dài video.
Thêm mô hình video
Các API tạo video khác trên Mage
Grok Video API
Grok Imagine, chuyển động
Kiwi API
Video hằng ngày, không cần cài đặt
Lemon API
Đủ mọi tính năng video, với mức giá dễ chịu hơn
LTX Video API
Video open-weights nhanh để thử nghiệm liên tục
Magejutsu API
Tái tạo mọi video, giữ nguyên chuyển động
Melon API
Anime chuyển động, có thể kèm âm thanh
FAQ
Câu hỏi thường gặp
Cherry API có giá bao nhiêu?
Endpoint của Cherry API là gì?
Tôi có thể gọi những model Cherry nào?
Cherry có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Tôi có thể dùng Cherry từ Claude hoặc ChatGPT không?
Kết quả Cherry đượ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.