Mage API · Mô hình video
API Berry
Video bám sát ảnh tham chiếu của bạn
POST https://api.mage.space/v1/berry/generateXem nhanh
API Berry chạy Berry 2 và 1 biến thể khác qua Mage tại POST https://api.mage.space/v1/berry/generate. Một yêu cầu với cài đặt mặc định có giá 189 Gems (khoảng $0.189), không cần đăng ký gói. Berry nhận Characters đã lưu và ảnh tham chiếu qua @handle trong prompt.
- VideoĐầu ra
- 2Biến thể
- 189Gems mỗi clip, mặc định
- $0.189Khoảng, tính bằng USD
Tổng quan
API Berry làm được gì
Video bám sát từng ảnh tham chiếu bạn đưa vào. Một khung hình đầu, tối đa 9 ảnh tham chiếu hoặc Characters, hoặc một video nguồn để chỉnh sửa; dài từ 3 đến 15 giây, độ phân giải tối đa 1080p.
Mô hình video dựa trên tham chiếu của Mage, bám sát các ảnh bạn đưa vào; Berry 2 là phiên bản hiện tại. Dùng khung hình đầu hoặc ảnh tham chiếu, hoặc một video nguồn để chỉnh sửa.
Mô hình nhận các đầu vào: first_image, image, additional_images, video.
Bắt đầu nhanh
Gọi API Berry
Đặt MAGE_API_KEY, gửi yêu cầu đến /berry/generate và truy vấn status_url cho đến khi yêu cầu hoàn tất.
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"])Mô hình
Các giá trị model_id của Berry
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 |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Có |
Tùy chọn
Tham số của Berry
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, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Đầu vào
Đầu vào media mà Berry 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. |
| image | Ảnh tham chiếu. |
| additional_images | Các ảnh tham chiếu bổ sung. |
| video | Video nguồn. |
Quy tắc
Những quy tắc Berry API áp dụng
- Không thể kết hợp khung hình đầu với ảnh tham chiếu.
- Chỉnh sửa video chỉ chạy trên `berry`, không chạy trên `berry-2`: hãy gửi `model_id: "berry"` kèm video nguồn dài từ 3 đến 60 giây.
Thêm mô hình video
Các API tạo video khác trên Mage
Blueberry API
Cố định khung hình đầu và cuối
Cherry API
Dòng mô hình video chủ lực của chúng tôi
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
FAQ
Câu hỏi thường gặp
Berry API có giá bao nhiêu?
Endpoint của Berry API là gì?
Tôi có thể gọi những mô hình Berry nào?
Berry có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Tôi có thể dùng Berry từ Claude hoặc ChatGPT không?
Kết quả Berry đượ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.