ดูแบบเร็ว ๆ
Plum API รัน Plum Max และอีก 1 รุ่นผ่าน Mage ที่ POST https://api.mage.space/v1/plum/generate คำขอที่ใช้การตั้งค่าเริ่มต้นราคา 338 Gems (ประมาณ $0.338) ไม่ต้องสมัครสมาชิก Plum รองรับตัวละคร ภาพอ้างอิง และเสียงอ้างอิงที่บันทึกไว้ โดยใช้ @handle ในพรอมต์
วิดีโอ
ผลลัพธ์
2
รุ่น
338
Gems ต่อคลิป (ค่าเริ่มต้น)
$0.338
ประมาณ (USD)
ภาพรวม
Plum API ทำอะไรได้บ้าง
วิดีโอครบฟีเจอร์ มีเสียงในทุกคลิป และส่งออกได้สูงสุด 2K รองรับเฟรมเริ่มต้นและเฟรมสุดท้าย, References หรือ Characters สูงสุด 9 รายการ และ Voices ความยาว 4 ถึง 15 วินาที
โมเดลวิดีโอครบฟีเจอร์ของ Mage ที่สร้างเสียงให้ทุกคลิปและส่งออกได้สูงสุด 2K มีให้เลือกทั้ง Plum และ Plum Max ที่เร็วกว่า
รับ 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-max"
}' | 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-max',
});
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-max",
})
print(request["result"]["url"])โมเดล
ค่า model_id ของ Plum
ส่ง model_id เพื่อเลือกรุ่น หากไม่ระบุ ระบบจะใช้รุ่นเริ่มต้น
| model_id | ชื่อ | ค่าเริ่มต้น |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | ใช่ |
ตัวเลือก
พารามิเตอร์ของ Plum
ค่าที่ใช้ได้รวมทุกรุ่น บางรุ่นอาจมีตัวเลือกน้อยกว่า ดูตัวเลือกของแต่ละรุ่นได้ในเอกสาร
| ฟิลด์ | ค่า |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 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` เฟรมสุดท้ายต้องใช้คู่กับเฟรมแรก
- การตัดต่อวิดีโอต้องใช้วิดีโอต้นฉบับ 1 รายการความยาว 2 ถึง 15 วินาที, `duration` ของผลลัพธ์ และรูปภาพอ้างอิงได้สูงสุด 2 รูป โดยนับรวมตัวละครและ References ที่กล่าวถึงด้วย ไม่รองรับเฟรม เสียงอ้างอิง หรือเสียงตัวละคร: หากต้องการกล่าวถึงตัวละครที่มีเสียง ให้ส่ง `use_character_voices: false`
- บน `plum-max` วิดีโอต้นฉบับคิดอัตราต่อวินาทีสูงกว่าวิดีโอผลลัพธ์ ดังนั้นที่ 768P การตัดต่อบน `plum-max` จึงมีค่าใช้จ่ายสูงกว่าบน `plum`
โมเดลวิดีโอเพิ่มเติม
API สร้างวิดีโอด้วย AI อื่นๆ บน Mage
วิดีโอ · เริ่มต้น 360 Gems
Raspberry API
ทำให้ตัวละครมีชีวิตขึ้นมาจากเฟรมแรก
วิดีโอ · เริ่มต้น 40 Gems
Wan Video v2.2 API
วิดีโอแบบโอเพนเวทส์ พร้อมรุ่น Lightning
วิดีโอ · เริ่มต้น 189 Gems
Berry API
วิดีโอที่ตรงกับภาพอ้างอิงของคุณ
วิดีโอ · เริ่มต้น 360 Gems
Blueberry API
กำหนดเฟรมแรกและเฟรมสุดท้าย
วิดีโอ · เริ่มต้น 618 Gems
Cherry API
โมเดลวิดีโอรุ่นเรือธงของเรา
วิดีโอ · เริ่มต้น 375 Gems
Grok Video API
Grok Imagine แบบเคลื่อนไหว
คำถามที่พบบ่อย
คำถามที่พบบ่อย
Plum API ราคาเท่าไร
คำขอ Plum ที่ใช้ค่าเริ่มต้น (Plum Max) ราคา 338 Gems หรือประมาณ $0.338 ความละเอียด ความยาว และรุ่นอื่นจะทำให้ราคาเปลี่ยนไป โดยการตอบกลับจะแจ้งยอดที่เรียกเก็บจริง หากสร้างไม่สำเร็จจะได้รับเงินคืน แต่ถ้าถูกบล็อกตามนโยบายเนื้อหาของ 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 Max
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 ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง