เรียกครั้งเดียว ได้สื่อที่เสร็จสมบูรณ์
run จะส่งคำสั่งสร้าง โพลด้วย backoff ตามที่ API แนะนำ และคืนคำขอที่เสร็จสมบูรณ์พร้อม result.url
ดูแบบเร็ว ๆ
Mage เผยแพร่ SDK โอเพนซอร์สสำหรับ API ได้แก่ @mage-space/sdk บน npm สำหรับ TypeScript และ JavaScript, mage-space บน PyPI สำหรับ Python และชุดโหนด comfyui-mage สำหรับ ComfyUI แต่ละตัวครอบ REST API พร้อมค่ากำหนดแบบ typed สำหรับทั้ง 28 โมเดล การโพลอัตโนมัติ การลองใหม่แบบ idempotent และการอัปโหลด
3
SDK และการเชื่อมต่อ
28
โมเดลแบบ typed
MIT
โอเพนซอร์ส
$0
วิธีติดตั้ง
เลือกที่ใช่สำหรับคุณ
SDK และการเชื่อมต่อ
npm install @mage-space/sdk
TypeScript SDK
สร้างภาพ วิดีโอ และเสียงจาก Node.js ด้วยค่ากำหนดแบบ typed สำหรับทุกโมเดลของ Mage เรียกครั้งเดียวก็ส่งงาน รอ และรับผลลัพธ์กลับมา
pip install mage-space
Python SDK
สร้างภาพ วิดีโอ และเสียงจาก Python ด้วยไคลเอนต์แบบ sync และ asyncio พร้อมค่ากำหนดแบบ typed สำหรับทุกโมเดลของ Mage
comfy node install comfyui-mage
Mage สำหรับ ComfyUI
Mango, Cherry, Seed Audio และโมเดล Mage อื่นๆ ทุกตัวในรูปแบบโหนด ComfyUI ไม่ต้องมี GPU ไม่ต้องดาวน์โหลดโมเดล
เริ่มต้นอย่างรวดเร็ว
สร้างผลงานชิ้นแรกด้วย SDK
ติดตั้งแพ็กเกจ export 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"])มีมาให้ในตัว
สิ่งที่ SDK ทุกตัวจัดการให้คุณ
ลองใหม่โดยไม่เสียเงินซ้ำ
ทุกการส่งงานมี idempotency key หากเกิดข้อผิดพลาดของเครือข่ายหรือเซิร์ฟเวอร์ ระบบจะลองใหม่ด้วย backoff และการส่งงานซ้ำจะไม่ถูกเรียกเก็บเงินอีก
อัปโหลดในครั้งเดียว
ไฟล์ที่ใหญ่เกินกว่าจะใช้ data URL จะอัปโหลดผ่านลิงก์ที่ลงนามไว้ โดย SDK จัดการทั้งตั๋วอัปโหลด การ PUT และการตรวจขนาดไฟล์ให้
ข้อผิดพลาดที่เข้าใจง่าย
เมื่อ API ปฏิเสธคำขอ จะมี HTTP status, รหัสข้อผิดพลาด และ request id ให้ครบ ส่วนการสร้างที่ล้มเหลวหรือถูกยกเลิก และการหมดเวลา ก็มีประเภทข้อผิดพลาดของตัวเอง
แพ็กเกจ
ดาวน์โหลดได้ที่ไหน
| SDK | แพ็กเกจ | ติดตั้ง | ซอร์สโค้ด |
|---|---|---|---|
| TypeScript SDK | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK | mage-space | pip install mage-space | GitHub |
| Mage สำหรับ ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
คำถามที่พบบ่อย
คำถามที่พบบ่อย
Mage SDK ใช้ฟรีและเป็นโอเพนซอร์สหรือไม่
ใช่ SDK และโหนด ComfyUI เป็นโอเพนซอร์สภายใต้สัญญาอนุญาต MIT บน GitHub และติดตั้งได้ฟรี คุณจ่ายเฉพาะการสร้างที่รันจริง เป็น Gems ตามราคาที่แสดงไว้ของแต่ละโมเดล
โมเดล Mage ใหม่ใช้กับ SDK เวอร์ชันเก่าได้ไหม
ได้ แค่ส่ง id ของโมเดลใหม่เป็นสตริงก็รันได้เลย โดย SDK จะตรวจสอบค่ากำหนดกับฟิลด์ที่ทุกโมเดลใช้ร่วมกัน บอตจะอัปเดตไทป์ทุกครั้งที่เอกสารอ้างอิง API เปลี่ยน โมเดลใหม่จึงมาพร้อมไทป์ของตัวเองในรุ่นถัดไป
SDK ป้องกันการจ่ายเงินซ้ำเมื่อลองส่งคำขอใหม่ได้อย่างไร
ทุกคำขอที่ส่งจะมี Idempotency-Key SDK จะสร้างคีย์ใหม่ในแต่ละการเรียก และใช้คีย์เดิมเมื่อลองเรียกนั้นซ้ำเอง ดังนั้นการส่งซ้ำจะได้คำขอเดิมกลับมาและไม่มีการเรียกเก็บเงินเพิ่ม
SDK เสถียรหรือยัง
ตอนนี้เป็นเวอร์ชันเบต้า 0.x จึงอาจมีการเปลี่ยนแปลงในเวอร์ชันย่อยได้ ส่วน API เองแยกเวอร์ชันต่างหากและจะคงที่ภายใน v1
Mage API ราคาเท่าไร
ไม่มีค่าสมาชิกหรือค่ารายเดือน การสร้างแต่ละครั้งจ่ายเป็น Gems ตามราคาของโมเดลนั้น โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน หน้าโมเดลทุกหน้าแสดงราคาตามการตั้งค่าเริ่มต้น และผลลัพธ์ของแต่ละคำขอจะระบุยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะได้รับเงินคืน แต่หากถูกบล็อกโดยนโยบายเนื้อหาของ Mage จะไม่คืนให้ หากยอดคงเหลือไม่พอสำหรับคำขอ ระบบจะปฏิเสธก่อนเรียกเก็บเงินใดๆ
ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม
ไม่ต้อง API ใช้ Gems เท่านั้น แพ็กเกจสมาชิกและสิทธิ์สร้างไม่จำกัดในแอปไม่มีผลกับคำขอ API ดังนั้นบัญชี Mage ใดก็ตามที่มี Gems ก็เรียกใช้ได้
นำผลลัพธ์จาก API ไปใช้เชิงพาณิชย์ได้ไหม
ได้ คอนเทนต์ที่คุณสร้างด้วย Mage รวมถึงที่สร้างผ่าน API และเซิร์ฟเวอร์ MCP นำไปใช้เชิงพาณิชย์ได้ ยินดีหากให้เครดิต แต่ไม่จำเป็น
เริ่มสร้างสรรค์ด้วย Mage
หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง