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

Mage API · การสร้างวิดีโอ

API สร้างวิดีโอด้วย AI จากข้อความหรือรูปภาพ

แปลงข้อความเป็นวิดีโอ รูปภาพเป็นวิดีโอ เฟรมแรกและเฟรมสุดท้าย และภาพอ้างอิงเป็นวิดีโอ จาก 15 โมเดล นำโดย Cherry 2 Pro โมเดลเรือธงของ Mage พร้อมเสียงในหลายคลิป

POST https://api.mage.space/v1/{model}/generate

ดูแบบเร็ว ๆ

API สร้างวิดีโอของ Mage คือ REST API ที่ https://api.mage.space/v1 ซึ่งรัน 15 โมเดลแปลงข้อความเป็นวิดีโอและรูปภาพเป็นวิดีโอ รวมถึง Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video และ Wan ส่งพรอมต์พร้อมเฟรมหรือภาพอ้างอิงตามต้องการ จากนั้นตรวจสอบสถานะคำขอและดาวน์โหลดไฟล์ MP4 แต่ละคลิปจ่ายด้วย Gems ตามโมเดล ความละเอียด และความยาว

  • 15โมเดลวิดีโอ
  • $0.02ค่าเริ่มต้นที่ถูกที่สุด ต่อคลิป
  • 20งานสร้างพร้อมกัน
  • $0ค่าบริการรายเดือน

โมเดล

โมเดลวิดีโอทั้งหมดใน Mage API

ราคาคิดต่อการสร้างหนึ่งครั้ง เป็น Gems โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน และแพ็กที่ใหญ่กว่าจะได้ Gems โบนัสเพิ่ม ราคาขึ้นอยู่กับโมเดล ความละเอียด และความยาว ที่แสดงคือราคาตามการตั้งค่าเริ่มต้น และทุกการตอบกลับจะระบุยอดที่เรียกเก็บจริงใน billing.gems_charged หากการสร้างล้มเหลวจะคืน Gems ให้ แต่หากถูกบล็อกตามนโยบายเนื้อหาของ Mage จะไม่คืน

โมเดลเหมาะที่สุดสำหรับค่า model_idราคาเริ่มต้น
Berryวิดีโอที่ตรงกับภาพอ้างอิงของคุณberry, berry-2189 Gems ($0.189)
Blueberryกำหนดเฟรมแรกและเฟรมสุดท้ายblueberry, blueberry-v2360 Gems ($0.36)
Cherryตระกูลวิดีโอเรือธงของเราcherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine แบบเคลื่อนไหวgrok-imagine-video375 Gems ($0.375)
Kiwiวิดีโอใช้งานทั่วไป ไม่ต้องตั้งค่าkiwi270 Gems ($0.27)
Lemonครบทุกฟีเจอร์วิดีโอ ในราคาที่เป็นมิตรกว่าlemon245 Gems ($0.245)
LTX Videoวิดีโอโอเพนเวทที่เร็ว เหมาะกับการลองซ้ำltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
Magejutsuเปลี่ยนตัวแสดงในวิดีโอใดก็ได้ โดยคงการเคลื่อนไหวเดิมmagejutsu, magejutsu-lite, magejutsu-feather1,856 Gems ($1.856)
Melonอนิเมะเคลื่อนไหว พร้อมเสียงที่เลือกได้melon, melon-pro147 Gems ($0.147)
MiniMax-H3วิดีโอโอเพนที่เร็ว พร้อมเสียงสเตอริโอminimax-h3-turbo, pika-h3-flex, minimax-h345 Gems ($0.045)
Plumมีเสียงในทุกคลิป สูงสุด 2Kplum, plum-max, plum-fast173 Gems ($0.173)
Raspberryตัวละครที่มีชีวิตขึ้นมาจากเฟรมแรกraspberry360 Gems ($0.36)
SeedanceSeedance พร้อมตัวกรองเนื้อหาที่เข้มงวดseedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5618 Gems ($0.618)
Wan 3.0Wan 3.0 พร้อมตัวกรองแบบเข้มงวดwan-3.0245 Gems ($0.245)
Wan Video v2.2วิดีโอโอเพนเวท พร้อมรุ่น Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

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

สร้างวิดีโอด้วย Berry 2

ตั้งค่า MAGE_API_KEY ส่งคำขอ แล้วโพลจนกว่าจะเสร็จ เปลี่ยน berry ใน URL เป็นโมเดลใดก็ได้ข้างต้น

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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

วิธีการทำงาน

จาก API key สู่สื่อที่เสร็จสมบูรณ์ใน 3 คำขอ

ทุกโมเดลใช้รูปแบบการยืนยันตัวตนเดียวกัน วงจรคำขอแบบอะซิงโครนัสเดียวกัน และชื่อฟิลด์เหมือนกัน

  1. สร้าง API key

    ลงชื่อเข้าใช้ Mage เปิด API → API Keys แล้วสร้างคีย์ คีย์จะขึ้นต้นด้วย mage_sk_ และแสดงให้เห็นเพียงครั้งเดียว หนึ่งบัญชีมีคีย์ที่ใช้งานอยู่ได้ 10 คีย์

  2. ส่งคำขอสร้าง

    ส่ง POST พร้อมเนื้อหา JSON ไปที่ https://api.mage.space/v1/{model}/generate พร้อมเฮดเดอร์ Authorization: Bearer ระบบจะตอบกลับทันทีพร้อม request_id, status และ status_url ส่งเฮดเดอร์ Idempotency-Key ด้วย เพื่อไม่ให้การลองซ้ำถูกเรียกเก็บเงินสองครั้ง

  3. ตรวจสอบสถานะและดาวน์โหลด

    ตรวจสอบ status_url ต่อเนื่องจนกว่าสถานะจะเป็น completed, failed หรือ cancelled คำขอที่เสร็จสมบูรณ์จะมี result.url ที่ชี้ไปยังไฟล์ภาพ วิดีโอ หรือเสียง โดยเก็บไว้ 30 วัน

สร้างมาเพื่อใช้งานจริง

ทุกคำขอของ Mage API ได้อะไรบ้าง

  • คีย์เดียว ใช้ได้ทุกโมเดล

    โมเดลสร้างภาพ วิดีโอ และเสียง 37 โมเดลผ่าน REST API เดียวและยอด Gems เดียว สลับโมเดลได้แค่เปลี่ยนพาธใน URL

  • จ่ายตามการสร้างจริง

    ไม่มีค่าสมาชิกและไม่มีขั้นต่ำ คุณซื้อ Gems แล้วแต่ละคำขอจะถูกคิดตามราคาที่แสดงไว้ หากการสร้างล้มเหลวจะได้รับเงินคืน เว้นแต่ถูกบล็อกโดยนโยบายเนื้อหาของ Mage

  • ลองส่งซ้ำได้อย่างปลอดภัย

    Idempotency key ช่วยให้การส่งซ้ำได้ผลลัพธ์ของคำขอเดิม โดยไม่ถูกเรียกเก็บเงินอีก

  • ตัวละครที่คงเดิมทุกครั้ง

    บันทึกตัวละครหรือภาพอ้างอิงไว้ครั้งเดียว แล้วพิมพ์ @handle ในพรอมต์ใดก็ได้เพื่อใช้กับทุกโมเดลที่รองรับ

  • รองรับอินพุตขนาดใหญ่

    ส่งอินพุตภาพ วิดีโอ และเสียงเป็น URL หรือ data URL หรืออัปโหลดไฟล์ได้สูงสุด 100 MB ผ่านการอัปโหลดแบบมีลายเซ็น

  • สร้างพร้อมกันได้ 20 งาน

    แต่ละบัญชีสร้างพร้อมกันได้ 20 งาน และสามารถขยายขีดจำกัดให้เหมาะกับการใช้งานของคุณได้ คำขอที่ถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน

กรณีการใช้งาน

สิ่งที่นักพัฒนาสร้างด้วย Video API

  • วิดีโอสั้นและวิดีโอโซเชียล

    สร้างคลิปแนวตั้งสำหรับ TikTok, Reels และ Shorts จากพรอมต์หรือรูปภาพสินค้า

  • ทำให้ภาพนิ่งเคลื่อนไหว

    เปลี่ยนเฟรมแรก หรือเฟรมแรกและเฟรมสุดท้าย ให้เป็นภาพเคลื่อนไหวด้วยโมเดลแปลงภาพเป็นวิดีโออย่าง Lemon และ Kiwi

  • เรื่องราวที่ขับเคลื่อนด้วยตัวละคร

    รักษาตัวละครเดิมในทุกช็อตด้วยโมเดลภาพอ้างอิงเป็นวิดีโอที่รองรับตัวละครแบบ @handle

  • วิดีโอพร้อมเสียง

    Plum และโมเดลอื่นๆ สร้างเสียงพูด เสียงเอฟเฟกต์ และเสียงบรรยากาศไปพร้อมกับภาพ และรับเสียงอ้างอิงสำหรับเสียงพูดได้

  • โฆษณาและเดโมสินค้า

    สร้างโฆษณาหลายเวอร์ชันแล้วเลือกอันที่ดีที่สุด พร้อมการส่งแบบ idempotent ที่ไม่มีวันคิดเงินซ้ำ

  • แก้ไขคลิปที่มีอยู่

    Berry, Plum และ Grok Video แก้ไขวิดีโอต้นฉบับที่คุณส่งได้ ส่วน Lemon และ MiniMax-H3 รับวิดีโออ้างอิงด้วย

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

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

API สร้างวิดีโอด้วย AI ที่ดีที่สุดคืออะไร
บน Mage วิดีโอจะใช้ Cherry 2 Pro เป็นค่าเริ่มต้น รองรับตัวละคร รูปภาพอ้างอิงได้หลายภาพ ไฟล์เสียงอ้างอิง เอาต์พุตตั้งแต่ 480p ไปจนถึง 4K และคลิปยาวสูงสุด 30 วินาที ถ้าอยากควบคุมเฟรมแรกและเฟรมสุดท้าย ให้เลือก Lemon ถ้าต้องการคลิปที่มีเสียงที่สร้างขึ้นมาให้ความละเอียดสูงสุด 2K ให้เลือก Plum และถ้าต้องการดราฟต์ราคาประหยัดกว่า ให้เลือก Cherry Mini หรือ Wan
Video API รองรับการแปลงภาพเป็นวิดีโอไหม
รองรับ โมเดลแปลงภาพเป็นวิดีโอรับเฟรมแรก และบางรุ่นรับเฟรมสุดท้ายหรือภาพอ้างอิงด้วย ในรูปแบบ URL, data URL หรืออัปโหลด หน้าโมเดลแต่ละรุ่นจะแสดงอินพุตและระบุว่าจำเป็นต้องมีรูปภาพหรือไม่
วิดีโอที่สร้างได้ยาวแค่ไหน
ขึ้นอยู่กับโมเดลและความละเอียด โมเดลส่วนใหญ่สร้างคลิปยาว 4 ถึง 15 วินาที ส่วน Cherry 2 Pro และ Cherry 2 สร้างได้ถึง 20, 25 และ 30 วินาที ดูความยาวที่รองรับได้ในหน้าของแต่ละโมเดล
การสร้างวิดีโอใช้เวลานานแค่ไหน
ขึ้นอยู่กับโมเดล ความละเอียด และความยาว API ทำงานแบบอะซิงโครนัส คือส่งคำขอ แล้วโพล status_url แบบ backoff หรือให้ไคลเอนต์ MCP ของคุณรอด้วย get_request
Mage API ราคาเท่าไร
ไม่มีค่าสมาชิกหรือค่ารายเดือน การสร้างแต่ละครั้งจ่ายเป็น Gems ตามราคาของโมเดลนั้น โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน หน้าโมเดลทุกหน้าแสดงราคาตามการตั้งค่าเริ่มต้น และผลลัพธ์ของแต่ละคำขอจะระบุยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะได้รับเงินคืน แต่หากถูกบล็อกโดยนโยบายเนื้อหาของ Mage จะไม่คืนให้ หากยอดคงเหลือไม่พอสำหรับคำขอ ระบบจะปฏิเสธก่อนเรียกเก็บเงินใดๆ
ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม
ไม่ได้ API ใช้งานด้วย Gems เท่านั้น แผนสมาชิกและสิทธิ์สร้างไม่จำกัดในแอปไม่ครอบคลุมคำขอ API นอกจากนี้บัญชีต้องชำระเงินสำเร็จอย่างน้อยหนึ่งครั้งก่อน ไม่ว่าจะเป็นแพ็ก Gem หรือแผนใดก็ได้ โดย Gems โบนัสจากการสมัครใช้ได้ในแอป Mage เท่านั้น
นำผลลัพธ์จาก API ไปใช้เชิงพาณิชย์ได้ไหม
ได้ คอนเทนต์ที่คุณสร้างด้วย Mage รวมถึงที่สร้างผ่าน API และเซิร์ฟเวอร์ MCP นำไปใช้เชิงพาณิชย์ได้ ยินดีหากให้เครดิต แต่ไม่จำเป็น
ขีดจำกัดอัตราการใช้งาน (rate limit) เป็นอย่างไร?
หนึ่งบัญชีมีงานสร้างที่อยู่ในคิวหรือกำลังทำงานพร้อมกันได้ 20 งาน หากส่งเกินจากนั้นจะถูกปฏิเสธด้วยรหัส 429 และไม่เสียค่าใช้จ่าย หากต้องการเพิ่มขีดจำกัดให้เหมาะกับการใช้งานของคุณ ติดต่อได้ที่ [email protected]
เอเจนต์ AI ของฉันใช้ Mage API ได้ไหม?
ได้ เอเจนต์เรียกใช้ REST API ด้วยคีย์ หรือเชื่อมต่อกับเซิร์ฟเวอร์ MCP ของ Mage ซึ่งมีเครื่องมือสำเร็จรูป 16 รายการให้ Claude, ChatGPT, Claude Code, Grok และ Cursor ใช้เลือกโมเดล ตีราคา สร้าง และดึงผลลัพธ์ ดู เซิร์ฟเวอร์ MCP.
มี SDK สำหรับ Mage API ไหม?
มี แพ็กเกจทางการ @mage-space/sdk บน npm และ mage-space บน PyPI เป็นโอเพนซอร์สและมี type ครบทุกโมเดล ทำหน้าที่ส่งคำขอ รอผลลัพธ์ ลองใหม่อย่างปลอดภัย และอัปโหลดไฟล์ให้คุณ ผู้ใช้ ComfyUI ติดตั้งชุดโหนด comfyui-mage ได้ ดู Mage SDK.
ฉันใช้ API สร้างคอนเทนต์ของเจ้าอื่นอยู่แล้ว ต้องเปลี่ยนอะไรบ้าง?
ชี้ไคลเอนต์ของคุณไปที่ https://api.mage.space/v1 ส่งคีย์ Mage เป็น Bearer token แล้วแมปฟิลด์ของคุณตามหน้าโมเดล: prompt, aspect_ratio, resolution, duration และ model_id ใช้งานแบบเดียวกันในทุกโมเดลของ Mage คำขอทำงานแบบอะซิงโครนัส จึงต้องส่งคำขอก่อน แล้วโพลล์ที่ status_url

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

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

Charactersชุมชน