Mage API · SDK
SDK อย่างเป็นทางการสำหรับ Mage API
ไคลเอนต์แบบ typed สำหรับ TypeScript และ Python พร้อมโหนด Mage สำหรับ ComfyUI ใช้โมเดลสร้างภาพ วิดีโอ และเสียงได้ทุกตัวในโค้ดไม่กี่บรรทัด
ดูแบบเร็ว ๆ
Mage เผยแพร่ SDK โอเพนซอร์สสำหรับ API ได้แก่ @mage-space/sdk บน npm สำหรับ TypeScript และ JavaScript, mage-space บน PyPI สำหรับ Python และชุดโหนด comfyui-mage สำหรับ ComfyUI ทุกตัวครอบ REST API พร้อมคอนฟิกแบบมีชนิดข้อมูลสำหรับทั้ง 37 โมเดล การโพลอัตโนมัติ การลองใหม่แบบ idempotent และการอัปโหลด
- 3SDK และการเชื่อมต่อ
- 37โมเดลแบบ typed
- MITโอเพนซอร์ส
- $0วิธีติดตั้ง
เลือกที่ใช่สำหรับคุณ
SDK และการเชื่อมต่อ
npm install @mage-space/sdkTypeScript SDK
สร้างภาพ วิดีโอ และเสียงจาก Node.js ด้วยค่ากำหนดแบบ typed สำหรับทุกโมเดลของ Mage เรียกครั้งเดียวก็ส่งงาน รอ และรับผลลัพธ์กลับมา
pip install mage-spacePython SDK
สร้างภาพ วิดีโอ และเสียงจาก Python ด้วยไคลเอนต์แบบ sync และ asyncio พร้อมค่ากำหนดแบบ typed สำหรับทุกโมเดลของ Mage
comfy node install comfyui-mageMage สำหรับ 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-v4',
});
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-v4",
})
print(request["result"]["url"])มีมาให้ในตัว
สิ่งที่ SDK ทุกตัวจัดการให้คุณ
เรียกครั้งเดียว ได้สื่อที่เสร็จสมบูรณ์
run จะส่งคำสั่งสร้าง โพลด้วย backoff ตามที่ API แนะนำ และคืนคำขอที่เสร็จสมบูรณ์พร้อม result.url
ลองใหม่โดยไม่เสียเงินซ้ำ
ทุกการส่งงานมี 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 ใช้ฟรีและเป็นโอเพนซอร์สหรือไม่
โมเดล Mage ใหม่ใช้กับ SDK เวอร์ชันเก่าได้ไหม
SDK ป้องกันการจ่ายเงินซ้ำเมื่อลองส่งคำขอใหม่ได้อย่างไร
SDK เสถียรหรือยัง
Mage API ราคาเท่าไร
ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม
นำผลลัพธ์จาก API ไปใช้เชิงพาณิชย์ได้ไหม
เริ่มสร้างสรรค์ด้วย Mage
หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง