Chuyển đến nội dung

Mage API · Mô hình video

API Plum

Có âm thanh cho mọi clip, lên đến 2K

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

Xem nhanh

Plum API chạy Plum Fast và 2 biến thể khác qua Mage tại POST https://api.mage.space/v1/plum/generate. Một yêu cầu với cài đặt mặc định tốn 173 Gems (khoảng 0,173 $), không cần đăng ký gói. Plum nhận nhân vật, tham chiếu và tham chiếu âm thanh đã lưu thông qua @handle trong prompt.

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

Tổng quan

Plum API làm được gì

Video đầy đủ tính năng với âm thanh trên mọi clip và đầu ra lên đến 2K. Hỗ trợ khung hình đầu và cuối, tối đa 9 tham chiếu hoặc Characters, cùng Voices; dài từ 4 đến 15 giây.

Mô hình video đầy đủ tính năng của Mage, có âm thanh được tạo cho mọi clip và đầu ra đến 2K, gồm Plum, Plum Max nhanh hơn, và Plum Fast, nhanh nhất và giá thấp nhất.

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

Bắt đầu nhanh

Gọi Plum API

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Mô hình

Giá trị model_id của Plum

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
plumPlum
plum-maxPlum Max
plum-fastPlum FastCó

Tùy chọn

Tham số của Plum

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, 9:16, 1:1, 4:3, 3:4, 21:9
resolution768P, 2K, 480P
duration4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Đầu vào

Đầu vào media mà Plum 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.
last_imageẢnh khung hình cuối.
imageẢnh tham chiếu.
additional_imagesCác ảnh tham chiếu bổ sung.
videosCác video nguồn.

Quy tắc

Các quy tắc Plum API áp dụng

  • Không thể kết hợp khung hình đầu và cuối với ảnh tham chiếu: chỉ gửi một loại.
  • Với `plum-max` và `plum-fast`, khung hình cuối phải đi kèm khung hình đầu.
  • Chỉnh sửa video yêu cầu đúng một video nguồn dài 2 đến 15 giây, một `duration` đầu ra và tối đa 2 ảnh tham chiếu, tính cả nhân vật và tham chiếu được nhắc đến. Không dùng khung hình, tham chiếu âm thanh hay giọng nhân vật: hãy gửi `use_character_voices: false` để nhắc đến nhân vật có giọng nói.
  • Với `plum-max`, video nguồn được tính phí theo giây cao hơn video đầu ra, nên ở 768P, chỉnh sửa trên `plum-max` tốn kém hơn trên `plum`.

Thêm mô hình video

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

  • Video · từ 360 Gems

    Raspberry API

    Nhân vật sống động từ khung hình đầu tiên

  • Video · từ 618 Gems

    Seedance API

    Seedance, với bộ lọc nghiêm ngặt

  • Video · từ 245 Gems

    Wan 3.0 API

    Wan 3.0, với bộ lọc nghiêm ngặt

  • 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

FAQ

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

Plum API có giá bao nhiêu?
Một yêu cầu Plum với cài đặt mặc định (Plum Fast) tốn 173 Gems, khoảng 0,173 $. Độ phân giải, thời lượng và biến thể khác sẽ làm thay đổi giá; phản hồi sẽ cho biết chính xác mức phí. Nếu lượt tạo thất bại, bạn sẽ được hoàn lại Gems; nếu bị chặn theo chính sách nội dung của Mage thì không được hoàn.
Endpoint của Plum API là gì?
POST https://api.mage.space/v1/plum/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 Plum nào?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). Mặc định là Plum Fast.
Plum có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Plum nhận first_image, last_image, image, additional_images, videos. Plum dùng nhân vật đã lưu, tham chiếu và tham chiếu âm thanh thông qua @handle trong prompt.
Tôi có thể dùng Plum 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 Plum 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 Plum đượ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