API Berry

Xem 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

• 2

  Biến thể

• 189

  Gems mỗi clip, mặc định

• $0.189

  Khoả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.

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"

// 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);

# 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.

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.

Đầ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.

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

FAQ

Câu hỏi thường gặp

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.

Liên quan

• API tạo video AI
• Tài liệu tham khảo Berry API
• Sân chơi Berry
• Tất cả mô hình API
• Máy chủ MCP của Mage