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 | ชื่อ | ค่าเริ่มต้น |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | ใช่ |
ตัวเลือก
พารามิเตอร์ของ 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` และ `plum-fast` เฟรมสุดท้ายต้องใช้คู่กับเฟรมแรก
- การตัดต่อวิดีโอต้องใช้วิดีโอต้นฉบับ 1 รายการความยาว 2 ถึง 15 วินาที, `duration` ของผลลัพธ์ และรูปภาพอ้างอิงได้สูงสุด 2 รูป โดยนับรวมตัวละครและ References ที่กล่าวถึงด้วย ไม่รองรับเฟรม เสียงอ้างอิง หรือเสียงตัวละคร: หากต้องการกล่าวถึงตัวละครที่มีเสียง ให้ส่ง `use_character_voices: false`
- บน `plum-max` วิดีโอต้นฉบับคิดอัตราต่อวินาทีสูงกว่าวิดีโอผลลัพธ์ ดังนั้นที่ 768P การตัดต่อบน `plum-max` จึงมีค่าใช้จ่ายสูงกว่าบน `plum`
โมเดลวิดีโอเพิ่มเติม
API สร้างวิดีโอด้วย AI อื่นๆ บน Mage
Raspberry API
ทำให้ตัวละครมีชีวิตขึ้นมาจากเฟรมแรก
Seedance API
Seedance พร้อมตัวกรองเข้มงวด
Wan 3.0 API
Wan 3.0 พร้อมตัวกรองเข้มงวด
Wan Video v2.2 API
วิดีโอแบบโอเพนเวทส์ พร้อมรุ่น Lightning
Berry API
วิดีโอที่ตรงกับภาพอ้างอิงของคุณ
Blueberry API
กำหนดเฟรมแรกและเฟรมสุดท้าย
คำถามที่พบบ่อย
คำถามที่พบบ่อย
Plum API ราคาเท่าไร
เอนด์พอยต์ของ Plum API คืออะไร
เรียกใช้โมเดล Plum ใดได้บ้าง
Plum รองรับรูปภาพอ้างอิงหรือตัวละครไหม
ใช้ Plum จาก Claude หรือ ChatGPT ได้ไหม
ผลลัพธ์ของ Plum เก็บไว้นานแค่ไหน
เริ่มสร้างสรรค์ด้วย Mage
หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง