Chuyển đến nội dung

Mage API · Mô hình video

Blueberry API

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

POST https://api.mage.space/v1/blueberry/generate

Xem nhanh

Blueberry API chạy Blueberry và 1 biến thể khác thông qua Mage tại POST https://api.mage.space/v1/blueberry/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. Blueberry dùng các tham chiếu âm thanh đã lưu qua @handle trong prompt.

  • VideoĐầu ra
  • 2Biến thể
  • 360Gems mỗi clip, mặc định
  • $0.36Khoảng, tính bằng USD

Tổng quan

Blueberry API làm được gì

Đặt khung hình đầu và cuối, rồi xem chuyển động được tạo ra ở giữa, kèm âm thanh. Dài 2 đến 15 giây ở 720p hoặc 1080p.

Mô hình video tạo chuyển động giữa khung hình đầu và khung hình cuối, kèm âm thanh; Blueberry 2 là phiên bản hiện tại.

Mô hình nhận first_image, last_image làm đầu vào.

Bắt đầu nhanh

Gọi Blueberry API

Đặt MAGE_API_KEY, gửi yêu cầu tới /blueberry/generate, rồi kiểm tra status_url định kỳ cho đến khi yêu cầu hoàn tất.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/blueberry/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": "blueberry-v2"
}' | 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('blueberry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'blueberry-v2',
});

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Mô hình

Các giá trị model_id của Blueberry

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
blueberryBlueberry
blueberry-v2BlueberryCó

Tùy chọn

Tham số của Blueberry

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à Blueberry 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.
last_imageẢnh khung hình cuối.

Quy tắc

Những quy tắc Blueberry API áp dụng

  • Khung hình cuối chỉ được hỗ trợ trên `blueberry-v2`.

Thêm mô hình video

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

  • 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

  • Video · từ 245 Gems

    Lemon API

    Đủ mọi tính năng video, với mức giá dễ chịu hơn

  • Video · từ 20 Gems

    LTX Video API

    Video open-weights nhanh để thử nghiệm liên tục

  • Video · từ 1.856 Gem

    Magejutsu API

    Tái tạo mọi video, giữ nguyên chuyển động

FAQ

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

Blueberry API có giá bao nhiêu?
Một yêu cầu Blueberry với cài đặt mặc định (Blueberry) có giá 360 Gems, khoảng $0,36. Độ phân giải, thời lượng và biến thể khác sẽ làm giá thay đổi; phản hồi 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 Blueberry API là gì?
POST https://api.mage.space/v1/blueberry/generate với 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 định kỳ và lấy kết quả.
Tôi có thể gọi những mô hình Blueberry nào?
blueberry, blueberry-v2. Mặc định là Blueberry.
Blueberry có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Blueberry nhận first_image, last_image. Blueberry dùng các tham chiếu âm thanh đã lưu qua @handle trong prompt.
Tôi có thể dùng Blueberry 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 và gọi tên Blueberry. Trợ lý của bạn sẽ đọc các tùy chọn của model bằng get_model và báo giá trước khi tạo.
Kết quả Blueberry đượ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.

CharactersCộng đồng