ข้ามไปยังเนื้อหา
Playgroundเอกสารรับ API key

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

Magejutsu API

เปลี่ยนตัวแสดงในวิดีโอใดก็ได้ โดยคงการเคลื่อนไหวเดิม

รับ API keyลองใช้ Magejutsu ใน playground
POST https://api.mage.space/v1/magejutsu/generate

ดูแบบเร็ว ๆ

Magejutsu API รัน Magejutsu และอีก 2 เวอร์ชันผ่าน Mage ที่ POST https://api.mage.space/v1/magejutsu/generate คำขอที่ใช้ค่าเริ่มต้นใช้ 1,856 Gems (ประมาณ $1.856) โดยไม่ต้องสมัครสมาชิก Magejutsu รองรับตัวละครที่บันทึกไว้ และรูปอ้างอิงผ่าน @handle ในพรอมต์

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

ภาพรวม

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

เปลี่ยนตัวแสดงในวิดีโอที่คุณมีอยู่แล้ว: ส่งคลิปพร้อมรูปของคนหรือสิ่งที่จะมาแทน แล้วการเคลื่อนไหว มุมกล้อง จังหวะเวลา และเสียงจะคงเดิมตามที่ถ่ายไว้ วิดีโอต้นฉบับยาว 4 ถึง 30 วินาที

เปลี่ยนตัวแสดงในวิดีโอที่มีอยู่: ผู้กำกับจะเขียนพรอมต์แก้ไขจากวิดีโอต้นฉบับ แล้วขั้นตอนแก้ไขวิดีโอจะสร้างคนและสิ่งที่แสดงขึ้นใหม่ ส่งวิดีโอต้นฉบับและรูปอ้างอิงสำหรับตัวแทน ผลลัพธ์จะคงความยาว อัตราส่วน การเคลื่อนไหว และเสียงของต้นฉบับ

รองรับ image, additional_images และ videos เป็นอินพุต

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

เรียกใช้ Magejutsu API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
  "videos": [
    "https://example.com/input.jpg"
  ],
  "image": "https://example.com/input.jpg",
  "model_id": "magejutsu"
}' | 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('magejutsu', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  videos: [
    'https://example.com/input.jpg',
  ],
  image: 'https://example.com/input.jpg',
  model_id: 'magejutsu',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("magejutsu", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "videos": [
        "https://example.com/input.jpg",
    ],
    "image": "https://example.com/input.jpg",
    "model_id": "magejutsu",
})

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

โมเดล

ค่า model_id ของ Magejutsu

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

model_idชื่อค่าเริ่มต้น
magejutsuMagejutsuใช่
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

ตัวเลือก

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

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

ฟิลด์ค่า
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

อินพุต

สื่อที่ Magejutsu รับเป็นอินพุต

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

ฟิลด์บทบาท
imageภาพอ้างอิง
additional_imagesภาพอ้างอิงเพิ่มเติม
videosวิดีโอต้นฉบับ

กฎ

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

  • วิดีโอต้นฉบับต้องมีความยาว 4 ถึง 30 วินาทีบน magejutsu และ 4 ถึง 15 วินาทีบน magejutsu-lite ซึ่งเป็นรุ่นที่เร็วกว่าและถูกกว่า รวมถึงบน magejutsu-feather ซึ่งเป็นรุ่นที่ถูกและเร็วที่สุด โดยรองรับเฉพาะ motion_transfer และเรนเดอร์ที่ 480p และ 720p ผลลัพธ์จะมีความยาวและอัตราส่วนภาพตามวิดีโอต้นฉบับ
  • ทุกคำขอจะทำงานผ่านระบบ director ตัวเดียวกันในฝั่งเบื้องหลัง เลือก motion_transfer เพื่อสร้างนักแสดงขึ้นใหม่โดยคงการเคลื่อนไหวเดิมไว้ หรือเลือก object_swap เพื่อเปลี่ยนองค์ประกอบที่เลือกโดยคงส่วนอื่นของช็อตไว้ตามที่ถ่ายจริง โหมดนี้ยังกำหนดวิธีเตรียมต้นฉบับด้วย โดย motion transfer จะใช้การเคลื่อนไหวและใบหน้าของนักแสดงแต่ละคนที่ถูกแทนที่เป็นแนวทางในการแก้ไข ส่วน object swap จะแก้ไขต้นฉบับตามที่ถ่ายจริง หากคลิปไม่สามารถอ่านแนวทางได้ เช่น คลิปที่ไม่มีคนอยู่เลย ระบบจะเรนเดอร์จากต้นฉบับตามที่ถ่ายจริง ไม่มีขั้นตอนการอนุมัติด้วยตนเองหรือการเรนเดอร์ฉบับร่าง
  • ส่งภาพอ้างอิงได้สูงสุด 30 ภาพผ่าน image และ additional_images ผู้กำกับจะอ่านทุกภาพ และขั้นตอนแก้ไขจะได้รับภาพที่พรอมต์ใช้งาน: สูงสุด 27 ภาพบน magejutsu, 9 ภาพบน magejutsu-lite และ 8 ภาพบน magejutsu-feather
  • พรอมต์ไม่จำเป็นต้องมี หากไม่ใส่ director จะจับคู่รูปอ้างอิงกับต้นฉบับตามความโดดเด่นและความเหมาะสม
  • ระบบจะคืนเสียงต้นฉบับโดยค่าเริ่มต้น หากต้องการเก็บเสียงที่สร้างขึ้นไว้ ให้ตั้งค่า keep_original_audio เป็น false
  • ภาพคือสิ่งที่จะมาแทน ให้ระบุแต่ละภาพในพรอมต์ตามลำดับ (“ภาพที่ 1 คือคนทางซ้าย”)
  • หนึ่งคำขอรับวิดีโอต้นฉบับได้เพียงคลิปเดียวเท่านั้น และคลิปที่ยาวเกินจะถูกปฏิเสธแทนที่จะถูกตัด

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

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

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

    Melon API

    อนิเมะเคลื่อนไหว พร้อมเสียงตามต้องการ

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

    MiniMax-H3 API

    วิดีโอโอเพนซอร์สที่รวดเร็ว พร้อมเสียงสเตอริโอ

  • วิดีโอ · เริ่มที่ 173 Gems

    Plum API

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

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

    Raspberry API

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

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

    Wan Video v2.2 API

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

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

    Berry API

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

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

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

Magejutsu API ราคาเท่าไหร่
คำขอ Magejutsu ที่ใช้ค่าเริ่มต้น (Magejutsu) มีค่าใช้จ่าย 1,856 Gems หรือประมาณ $1.856 ความละเอียด ความยาว และเวอร์ชันอื่นจะทำให้ราคาเปลี่ยนไป โดยผลลัพธ์ที่ส่งกลับจะแจ้งยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะได้รับเงินคืน แต่ถ้าถูกบล็อกตามนโยบายเนื้อหาของ Mage จะไม่คืนให้
endpoint ของ Magejutsu API คืออะไร
POST https://api.mage.space/v1/magejutsu/generate พร้อมเฮดเดอร์ Authorization: Bearer ที่มี Mage API key ของคุณ ผลลัพธ์ที่ตอบกลับจะมี status_url ให้เรียกตรวจสอบเพื่อรับผลลัพธ์
เรียกใช้โมเดล Magejutsu ใดได้บ้าง
magejutsu (Magejutsu), magejutsu-lite (Magejutsu Lite), magejutsu-feather (Magejutsu Feather) ค่าเริ่มต้นคือ Magejutsu
Magejutsu รองรับภาพอ้างอิงหรือตัวละครไหม
Magejutsu รับ image, additional_images, videos และรองรับตัวละครที่บันทึกไว้ รวมถึงรูปอ้างอิงด้วย @handle ในพรอมต์
ใช้ Magejutsu จาก Claude หรือ ChatGPT ได้ไหม
ได้ เชื่อมต่อ Mage MCP server กับ Claude, ChatGPT, Claude Code, Grok หรือ Cursor แล้วเรียกใช้ Magejutsu ด้วยชื่อได้เลย ผู้ช่วยของคุณจะอ่านตัวเลือกด้วย get_model และแจ้งราคาก่อนเริ่มสร้าง
ผลลัพธ์ของ Magejutsu ถูกเก็บไว้นานแค่ไหน
ผลลัพธ์และอินพุตจะถูกเก็บไว้ 30 วัน ดาวน์โหลดสิ่งที่ต้องการเก็บไว้ลงในพื้นที่จัดเก็บของคุณเอง

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

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

รับ API keyลองใช้ Magejutsu ใน playground