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

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

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

รับ API keyอ่านเอกสาร API
POST https://api.mage.space/v1/{model}/generate

ดูแบบเร็ว ๆ

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

โมเดล

โมเดลวิดีโอทั้งหมดใน 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-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)
Melonอนิเมะเคลื่อนไหว พร้อมเสียงที่เลือกได้melon, melon-pro147 Gems ($0.147)
MiniMax-H3วิดีโอโอเพนที่เร็ว พร้อมเสียงสเตอริโอminimax-h3-turbo, minimax-h330 Gems ($0.03)
Plumมีเสียงในทุกคลิป สูงสุด 2Kplum, plum-max338 Gems ($0.338)
Raspberryตัวละครที่มีชีวิตขึ้นมาจากเฟรมแรกraspberry360 Gems ($0.36)
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 ได้อะไรบ้าง

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

โมเดลภาพ วิดีโอ และเสียง 28 โมเดลใน 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 ถึง 1080p และคลิปยาวสูงสุด 30 วินาที Lemon เหมาะกับการควบคุมเฟรมแรกและเฟรมสุดท้าย Plum เหมาะกับคลิปที่มีเสียงที่สร้างขึ้นสูงสุด 2K ส่วน Cherry Mini หรือ Wan เหมาะกับงานร่างที่ประหยัดกว่า

Video API รองรับการแปลงภาพเป็นวิดีโอไหม

รองรับ โมเดลแปลงภาพเป็นวิดีโอรับเฟรมแรก และบางรุ่นรับเฟรมสุดท้ายหรือภาพอ้างอิงด้วย ในรูปแบบ URL, data URL หรืออัปโหลด หน้าโมเดลแต่ละรุ่นจะแสดงอินพุตและระบุว่าจำเป็นต้องมีรูปภาพหรือไม่

วิดีโอที่สร้างได้ยาวแค่ไหน

ขึ้นอยู่กับโมเดลและความละเอียด หลายโมเดลสร้างได้ 4 ถึง 15 วินาที และ Cherry 2 Pro ทำได้ถึง 20, 25 และ 30 วินาที หน้าโมเดลแต่ละรุ่นจะแสดงความยาวที่รองรับ

การสร้างวิดีโอใช้เวลานานแค่ไหน

ขึ้นอยู่กับโมเดล ความละเอียด และความยาว API ทำงานแบบอะซิงโครนัส คือส่งคำขอ แล้วโพล status_url แบบ backoff หรือให้ไคลเอนต์ MCP ของคุณรอด้วย get_request

Mage API ราคาเท่าไร

ไม่มีค่าสมาชิกหรือค่ารายเดือน การสร้างแต่ละครั้งจ่ายเป็น Gems ตามราคาของโมเดลนั้น โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน หน้าโมเดลทุกหน้าแสดงราคาตามการตั้งค่าเริ่มต้น และผลลัพธ์ของแต่ละคำขอจะระบุยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะได้รับเงินคืน แต่หากถูกบล็อกโดยนโยบายเนื้อหาของ Mage จะไม่คืนให้ หากยอดคงเหลือไม่พอสำหรับคำขอ ระบบจะปฏิเสธก่อนเรียกเก็บเงินใดๆ

ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม

ไม่ต้อง API ใช้ Gems เท่านั้น แพ็กเกจสมาชิกและสิทธิ์สร้างไม่จำกัดในแอปไม่มีผลกับคำขอ API ดังนั้นบัญชี Mage ใดก็ตามที่มี Gems ก็เรียกใช้ได้

นำผลลัพธ์จาก 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 ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง

รับ API keyอ่านเอกสาร API

ที่เกี่ยวข้อง