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-2 | 189 Gems ($0.189) |
| Blueberry | กำหนดเฟรมแรกและเฟรมสุดท้าย | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | ตระกูลวิดีโอเรือธงของเรา | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine แบบเคลื่อนไหว | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | วิดีโอใช้งานทั่วไป ไม่ต้องตั้งค่า | kiwi | 270 Gems ($0.27) |
| Lemon | ครบทุกฟีเจอร์วิดีโอ ในราคาที่เป็นมิตรกว่า | lemon | 245 Gems ($0.245) |
| LTX Video | วิดีโอโอเพนเวทที่เร็ว เหมาะกับการลองซ้ำ | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | เปลี่ยนตัวแสดงในวิดีโอใดก็ได้ โดยคงการเคลื่อนไหวเดิม | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | อนิเมะเคลื่อนไหว พร้อมเสียงที่เลือกได้ | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | วิดีโอโอเพนที่เร็ว พร้อมเสียงสเตอริโอ | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | มีเสียงในทุกคลิป สูงสุด 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | ตัวละครที่มีชีวิตขึ้นมาจากเฟรมแรก | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance พร้อมตัวกรองเนื้อหาที่เข้มงวด | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0 พร้อมตัวกรองแบบเข้มงวด | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | วิดีโอโอเพนเวท พร้อมรุ่น Lightning | wan22-video, wan22-video-lightning | 40 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 คำขอ
ทุกโมเดลใช้รูปแบบการยืนยันตัวตนเดียวกัน วงจรคำขอแบบอะซิงโครนัสเดียวกัน และชื่อฟิลด์เหมือนกัน
สร้าง API key
ลงชื่อเข้าใช้ Mage เปิด API → API Keys แล้วสร้างคีย์ คีย์จะขึ้นต้นด้วย mage_sk_ และแสดงให้เห็นเพียงครั้งเดียว หนึ่งบัญชีมีคีย์ที่ใช้งานอยู่ได้ 10 คีย์
ส่งคำขอสร้าง
ส่ง POST พร้อมเนื้อหา JSON ไปที่ https://api.mage.space/v1/{model}/generate พร้อมเฮดเดอร์ Authorization: Bearer ระบบจะตอบกลับทันทีพร้อม request_id, status และ status_url ส่งเฮดเดอร์ Idempotency-Key ด้วย เพื่อไม่ให้การลองซ้ำถูกเรียกเก็บเงินสองครั้ง
ตรวจสอบสถานะและดาวน์โหลด
ตรวจสอบ 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 ที่ดีที่สุดคืออะไร
Video API รองรับการแปลงภาพเป็นวิดีโอไหม
วิดีโอที่สร้างได้ยาวแค่ไหน
การสร้างวิดีโอใช้เวลานานแค่ไหน
Mage API ราคาเท่าไร
ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม
นำผลลัพธ์จาก API ไปใช้เชิงพาณิชย์ได้ไหม
ขีดจำกัดอัตราการใช้งาน (rate limit) เป็นอย่างไร?
เอเจนต์ AI ของฉันใช้ Mage API ได้ไหม?
มี SDK สำหรับ Mage API ไหม?
ฉันใช้ API สร้างคอนเทนต์ของเจ้าอื่นอยู่แล้ว ต้องเปลี่ยนอะไรบ้าง?
เริ่มสร้างสรรค์ด้วย Mage
หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง