API Plum

Xem nhanh

API Plum chạy Plum Max và 1 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 338 Gems (khoảng $0.338), không cần đăng ký gói. Plum dùng nhân vật, tham chiếu và tham chiếu âm thanh đã lưu qua @handle trong prompt.

• Video

  Đầu ra

• 2

  Biến thể

• 338

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

• $0.338

  Khoả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, tạo âm thanh cho mọi clip và cho đầu ra lên đến 2K, gồm Plum và Plum Max nhanh hơn.

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.

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-max"
}' | 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('plum', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'plum-max',
});

console.log(request.result.url);

# 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-max",
})

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.

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.

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

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`, 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

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 Plum API
• Playground của Plum
• Tất cả mô hình API
• Máy chủ MCP của Mage