ข้ามไปยังเนื้อหา

Mage API · โมเดลวิดีโอ

Plum API

มีเสียงในทุกคลิป ความละเอียดสูงสุด 2K

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

ดูแบบเร็ว ๆ

Plum API ให้คุณรัน Plum Fast และอีก 2 เวอร์ชันผ่าน Mage ที่ POST https://api.mage.space/v1/plum/generate คำขอที่ใช้ค่าเริ่มต้นมีค่าใช้จ่าย 173 Gems (ประมาณ $0.173) โดยไม่ต้องสมัครสมาชิก Plum รองรับตัวละคร ภาพอ้างอิง และเสียงอ้างอิงที่บันทึกไว้ โดยเรียกใช้ด้วย @handle ในพรอมต์

  • วิดีโอผลลัพธ์
  • 3รุ่น
  • 173Gems ต่อคลิป (ค่าเริ่มต้น)
  • $0.173ประมาณ (USD)

ภาพรวม

Plum API ทำอะไรได้บ้าง

วิดีโอครบฟีเจอร์ มีเสียงในทุกคลิป และส่งออกได้สูงสุด 2K รองรับเฟรมเริ่มต้นและเฟรมสุดท้าย, References หรือ Characters สูงสุด 9 รายการ และ Voices ความยาว 4 ถึง 15 วินาที

โมเดลวิดีโอฟีเจอร์ครบของ Mage ที่สร้างเสียงให้ทุกคลิปและให้ผลลัพธ์ความละเอียดสูงสุด 2K มีให้เลือกทั้ง Plum, Plum Max ที่เร็วกว่า และ Plum Fast ที่เร็วที่สุดและราคาประหยัดที่สุด

รับ first_image, last_image, image, additional_images, videos เป็นอินพุต

เริ่มต้นอย่างรวดเร็ว

เรียกใช้ Plum API

ตั้งค่า MAGE_API_KEY ส่งคำขอไปที่ /plum/generate แล้วโพลล์ status_url จนกว่าคำขอจะเสร็จสมบูรณ์

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"])

โมเดล

ค่า model_id ของ Plum

ส่ง model_id เพื่อเลือกรุ่น หากไม่ระบุ ระบบจะใช้รุ่นเริ่มต้น

model_idชื่อค่าเริ่มต้น
plumPlum
plum-maxPlum Max
plum-fastPlum Fastใช่

ตัวเลือก

พารามิเตอร์ของ Plum

ค่าที่ใช้ได้รวมทุกรุ่น บางรุ่นอาจมีตัวเลือกน้อยกว่า ดูตัวเลือกของแต่ละรุ่นได้ในเอกสาร

ฟิลด์ค่า
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

อินพุต

สื่ออินพุตที่ Plum รองรับ

ส่งแต่ละรายการเป็น https URL, data URL หรืออัปโหลดไฟล์ขนาดไม่เกิน 100 MB

ฟิลด์บทบาท
first_imageภาพเฟรมแรก
last_imageภาพเฟรมสุดท้าย
imageภาพอ้างอิง
additional_imagesภาพอ้างอิงเพิ่มเติม
videosวิดีโอต้นฉบับ

กฎ

ข้อกำหนดที่ Plum API บังคับใช้

  • ไม่สามารถใช้เฟรมแรกและเฟรมสุดท้ายร่วมกับภาพอ้างอิงได้ โปรดส่งอย่างใดอย่างหนึ่งเท่านั้น
  • ใน `plum-max` และ `plum-fast` เฟรมสุดท้ายต้องใช้คู่กับเฟรมแรก
  • การตัดต่อวิดีโอต้องใช้วิดีโอต้นฉบับ 1 รายการความยาว 2 ถึง 15 วินาที, `duration` ของผลลัพธ์ และรูปภาพอ้างอิงได้สูงสุด 2 รูป โดยนับรวมตัวละครและ References ที่กล่าวถึงด้วย ไม่รองรับเฟรม เสียงอ้างอิง หรือเสียงตัวละคร: หากต้องการกล่าวถึงตัวละครที่มีเสียง ให้ส่ง `use_character_voices: false`
  • บน `plum-max` วิดีโอต้นฉบับคิดอัตราต่อวินาทีสูงกว่าวิดีโอผลลัพธ์ ดังนั้นที่ 768P การตัดต่อบน `plum-max` จึงมีค่าใช้จ่ายสูงกว่าบน `plum`

โมเดลวิดีโอเพิ่มเติม

API สร้างวิดีโอด้วย AI อื่นๆ บน Mage

  • วิดีโอ · เริ่มต้น 360 Gems

    Raspberry API

    ทำให้ตัวละครมีชีวิตขึ้นมาจากเฟรมแรก

  • วิดีโอ · เริ่มต้น 618 Gems

    Seedance API

    Seedance พร้อมตัวกรองเข้มงวด

  • วิดีโอ · เริ่มต้น 245 Gems

    Wan 3.0 API

    Wan 3.0 พร้อมตัวกรองเข้มงวด

  • วิดีโอ · เริ่มต้น 40 Gems

    Wan Video v2.2 API

    วิดีโอแบบโอเพนเวทส์ พร้อมรุ่น Lightning

  • วิดีโอ · เริ่มต้น 189 Gems

    Berry API

    วิดีโอที่ตรงกับภาพอ้างอิงของคุณ

  • วิดีโอ · เริ่มต้น 360 Gems

    Blueberry API

    กำหนดเฟรมแรกและเฟรมสุดท้าย

คำถามที่พบบ่อย

คำถามที่พบบ่อย

Plum API ราคาเท่าไร
คำขอ Plum ที่ใช้ค่าเริ่มต้น (Plum Fast) มีค่าใช้จ่าย 173 Gems หรือประมาณ $0.173 ความละเอียด ความยาว และเวอร์ชันอื่นจะทำให้ราคาเปลี่ยนไป โดยผลลัพธ์ที่ตอบกลับจะแจ้งยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะได้รับเงินคืน แต่หากถูกบล็อกตามนโยบายเนื้อหาของ Mage จะไม่คืนให้
เอนด์พอยต์ของ Plum API คืออะไร
POST https://api.mage.space/v1/plum/generate พร้อมเฮดเดอร์ Authorization: Bearer ที่ใส่ Mage API key ของคุณ การตอบกลับจะมี status_url ให้โพลล์เพื่อรับผลลัพธ์
เรียกใช้โมเดล Plum ใดได้บ้าง
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast) ค่าเริ่มต้นคือ Plum Fast
Plum รองรับรูปภาพอ้างอิงหรือตัวละครไหม
Plum รองรับ first_image, last_image, image, additional_images, videos และใช้ตัวละคร References และเสียงอ้างอิงที่บันทึกไว้ผ่าน @handle ในพรอมต์
ใช้ Plum จาก Claude หรือ ChatGPT ได้ไหม
ได้ เชื่อมต่อเซิร์ฟเวอร์ Mage MCP กับ Claude, ChatGPT, Claude Code, Grok หรือ Cursor แล้วเรียกใช้ Plum ด้วยชื่อได้เลย ผู้ช่วยของคุณจะอ่านตัวเลือกด้วย get_model และแจ้งราคาก่อนสร้าง
ผลลัพธ์ของ Plum เก็บไว้นานแค่ไหน
ผลลัพธ์และอินพุตจะถูกเก็บไว้ 30 วัน ดาวน์โหลดสิ่งที่ต้องการเก็บไว้ลงในพื้นที่จัดเก็บของคุณเอง

เริ่มสร้างสรรค์ด้วย Mage

หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง

Charactersชุมชน