Mage API · สร้างมาเพื่อไอเดียต่อไปของคุณ

API เดียว ความเป็นไปได้ไม่สิ้นสุด

นำสิ่งที่ดีที่สุดของ Mage ไปไว้ในผลิตภัณฑ์และผู้ช่วย AI ของคุณ สร้างภาพ วิดีโอ และเสียงได้ด้วย API key เดียวหรือการเชื่อมต่อ MCP เดียว

รับ API keyเชื่อมต่อผู้ช่วยของคุณอ่านเอกสาร API
https://api.mage.space/v1

ดูแบบเร็ว ๆ

Mage มี REST API สำหรับนักพัฒนาที่ https://api.mage.space/v1 และ MCP server แบบรีโมตที่ https://mcp.mage.space/mcp ทั้งสองใช้โมเดลสร้างภาพ วิดีโอ และเสียงชุดเดียวกัน 28 โมเดล รวมถึง Mango 3 และ Cherry 2 Pro ที่มีเฉพาะบน Mage ภายในบัญชีเดียว และทุกการสร้างจ่ายด้วย Gems โดยไม่มีค่าสมาชิก

ช่องทางเริ่มต้นใช้งาน

เรียกใช้จากโค้ด ผู้ช่วย AI หรือ ComfyUI

REST API

Mage API

ส่งคำขอสร้างจากโค้ดของคุณเองด้วยคีย์ รองรับคำขอแบบอะซิงโครนัส การลองซ้ำแบบ idempotent อัปโหลดไฟล์ได้ถึง 100 MB และประมวลผลพร้อมกันได้ 20 รายการ

SDK

SDK สำหรับ TypeScript และ Python

ไคลเอนต์ทางการแบบมีชนิดข้อมูล ที่ส่งคำขอ รอผลลัพธ์ ลองซ้ำอย่างปลอดภัย และอัปโหลดไฟล์ได้ในไม่กี่บรรทัด

MCP server

Mage MCP server

เชื่อมต่อ Claude, ChatGPT, Claude Code, Grok หรือ Cursor ด้วยการลงชื่อเข้าใช้ แล้วสั่งสร้างภาพ วิดีโอ และเสียงด้วยภาษาง่ายๆ

ComfyUI

Mage สำหรับ ComfyUI

Mango, Cherry, Seed Audio และโมเดล Mage อื่นๆ ทุกตัวในรูปแบบโหนด ComfyUI ไม่ต้องมี GPU ไม่ต้องดาวน์โหลดโมเดล

ตามประเภทสื่อ

API สำหรับการสร้าง

15 โมเดล

API สร้างภาพด้วย AI

สร้างภาพจากข้อความ แก้ไขภาพ และตัวละครที่หน้าตาคงเดิม ความละเอียดสูงสุด 4K

12 โมเดล

API สร้างวิดีโอด้วย AI

สร้างวิดีโอจากข้อความ จากภาพ จากเฟรม จากภาพอ้างอิง พร้อมเสียง

1 โมเดล

API สร้างเสียงด้วย AI

สร้างเสียงพูด คำบรรยาย เพลง และเสียงเอฟเฟกต์จากพรอมต์

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

การสร้างครั้งแรกของคุณ

สร้างคีย์ที่ API → API Keys ส่งออกเป็น MAGE_API_KEY แล้วรันตัวอย่างใดตัวอย่างหนึ่งต่อไปนี้

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "mango-v3"
}' | 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('mango', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'mango-v3',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("mango", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "mango-v3",
})

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 วัน

MCP

Mage ในผู้ช่วย AI ของคุณ

Mage ใน Claude

สร้างภาพ วิดีโอ และเสียงใน Claude บนเว็บ แอปเดสก์ท็อป แอปมือถือ และ Cowork

Mage ใน ChatGPT

สร้างภาพ วิดีโอ และเสียงใน ChatGPT ผ่านแอป MCP ส่วนตัว

Mage ใน Claude Code

สร้างภาพ วิดีโอ และเสียงใน Claude Code ทั้งในเทอร์มินัลและตัวแก้ไขโค้ด

Mage ใน Grok

สร้างภาพ วิดีโอ และเสียงใน Grok ผ่านคอนเนกเตอร์แบบกำหนดเอง

Mage ใน Cursor

สร้างภาพ วิดีโอ และเสียงในโหมด Agent ของ Cursor

โมเดล

โมเดลแนะนำ

ภาพ · เริ่มต้น 40 Gems

Flux 2 API

รองรับพรอมต์ยาวและการแก้ไขด้วยภาพอ้างอิงหลายภาพ

ภาพ · เริ่มต้น 9 Gems

GPT Image 2 API

พรอมต์แม่นยำ ข้อความอ่านชัด

ภาพ · เริ่มต้น 37 Gems

Guava API

ภาพสมจริงราวกับภาพถ่ายจริง

ภาพ · เริ่มต้น 135 Gems

Mango API

โมเดลภาพรุ่นเรือธงของเรา

ภาพ · เริ่มต้น 68 Gems

Nano Banana 2 API

ข้อความคมชัด อ่านง่าย สูงสุด 4K

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

Cherry API

โมเดลวิดีโอรุ่นเรือธงของเรา

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

Lemon API

ครบทุกฟีเจอร์วิดีโอ ในราคาที่เป็นมิตรกว่า

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

Plum API

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

เสียง · เริ่มต้น 19 Gems

Seed Audio API

เสียงพูด เพลง และเอฟเฟกต์เสียงจากพรอมต์เดียว

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Mage API คืออะไร

Mage API คือ REST API ที่ https://api.mage.space/v1 สำหรับสร้างภาพ วิดีโอ และเสียงด้วยโมเดล 28 โมเดลจากโค้ดของคุณเอง คำขอทำงานแบบอะซิงโครนัสและจ่ายตามการสร้างเป็น Gems

Mage MCP server คืออะไร

เซิร์ฟเวอร์ Model Context Protocol แบบรีโมตที่ https://mcp.mage.space/mcp ซึ่งให้ผู้ช่วย AI สร้างภาพ วิดีโอ และเสียงในบัญชี Mage ของคุณได้ โดยมีเครื่องมือ 16 อย่างให้ผู้ช่วยเลือกโมเดล ประเมินราคา สร้างงาน รอผลลัพธ์ และใช้ตัวละคร ภาพอ้างอิง และประวัติที่คุณบันทึกไว้

ต้องใช้ API key เพื่อใช้ MCP server ไหม

ไม่ต้อง Claude, ChatGPT, Grok, Cursor และ Claude Code เชื่อมต่อได้ด้วยการเข้าสู่ระบบ Mage ผ่าน OAuth ส่วน API key เป็นตัวเลือก ใช้สำหรับการตั้งค่าแบบไม่มีหน้าจอ เช่น CI

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เชื่อมต่อผู้ช่วยของคุณ

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