Mage API · Mô hình video

Raspberry API

Làm nhân vật sống động từ khung hình đầu

Lấy khóa APIDùng thử Raspberry trong playground
POST https://api.mage.space/v1/raspberry/generate

Xem nhanh

Raspberry API chạy Raspberry qua Mage tại POST https://api.mage.space/v1/raspberry/generate. Một yêu cầu với cài đặt mặc định có giá 360 Gems (khoảng $0,36), không cần đăng ký gói. Raspberry dùng nhân vật đã lưu và tham chiếu thông qua @handle trong prompt.

Tổng quan

Raspberry API làm được gì

Video nhân vật từ khung hình mở đầu cùng tối đa 5 tham chiếu hoặc Characters, có Voices và âm thanh. Dài 2 đến 15 giây ở 720p hoặc 1080p.

Mô hình video nhân vật tạo từ khung hình đầu và ảnh tham chiếu, có Voices và âm thanh.

Nhận first_image, image, additional_images làm đầu vào.

Bắt đầu nhanh

Gọi Raspberry API

Đặt MAGE_API_KEY, gửi yêu cầu đến /raspberry/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/raspberry/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": "raspberry"
}' | 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('raspberry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'raspberry',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("raspberry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "raspberry",
})

print(request["result"]["url"])

Mô hình

Giá trị model_id của Raspberry

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_idTênMặc định
raspberryRaspberryCó

Tùy chọn

Tham số của Raspberry

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ườngGiá trị
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution720p, 1080p
duration2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Đầu vào

Đầu vào media mà Raspberry 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ườngVai trò
first_imageẢnh khung hình đầu tiên.
imageẢnh tham chiếu.
additional_imagesCác ảnh tham chiếu bổ sung.

Thêm mô hình video

Các API tạo video khác trên Mage

Video · từ 40 Gems

Wan Video v2.2 API

Video open-weights có thêm biến thể Lightning

Video · từ 189 Gems

Berry API

Video bám sát các tham chiếu của bạn

Video · từ 360 Gems

Blueberry API

Cố định khung hình đầu và cuối

Video · từ 618 Gems

Cherry API

Dòng mô hình video chủ lực của chúng tôi

Video · từ 375 Gems

Grok Video API

Grok Imagine, chuyển động

Video · từ 270 Gems

Kiwi API

Video hằng ngày, không cần cài đặt

FAQ

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

Raspberry API có giá bao nhiêu?

Một yêu cầu Raspberry với cài đặt mặc định (Raspberry) có giá 360 Gems, khoảng $0,36. Độ phân giải, thời lượng và phiên bản khác sẽ làm giá thay đổi; phản hồi sẽ cho biết chính xác mức phí. Lượt tạo bị lỗi sẽ được hoàn tiền; lượt bị chính sách nội dung của Mage chặn thì không.

Endpoint của Raspberry API là gì?

POST https://api.mage.space/v1/raspberry/generate kèm header Authorization: Bearer chứa khóa API Mage của bạn. Phản hồi có status_url để bạn kiểm tra kết quả.

Tôi có thể gọi những mô hình Raspberry nào?

raspberry. Mặc định là Raspberry.

Raspberry có hỗ trợ ảnh tham chiếu hoặc nhân vật không?

Raspberry nhận first_image, image, additional_images. Raspberry dùng nhân vật đã lưu và tham chiếu thông qua @handle trong prompt.

Tôi có thể dùng Raspberry từ Claude hoặc ChatGPT không?

Có. Hãy kết nối máy chủ Mage MCP với Claude, ChatGPT, Claude Code, Grok hoặc Cursor rồi yêu cầu Raspberry theo tên. Trợ lý của bạn sẽ đọc các tùy chọn bằng get_model và báo giá trước khi tạo.

Kết quả của Raspberry được lưu trong bao lâu?

Kết quả và đầu vào được lưu trong 30 ngày. Hãy tải về bộ nhớ của bạn bất cứ thứ gì bạn muốn giữ lại.

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.

Lấy khóa APIDùng thử Raspberry trong playground

Liên quan