Mage TypeScript SDK

ดูแบบเร็ว ๆ

Mage TypeScript SDK คือไคลเอนต์โอเพนซอร์สตัวทางการของ Mage API เผยแพร่ในชื่อ @mage-space/sdk ติดตั้งด้วย "npm install @mage-space/sdk" ตั้งค่า MAGE_API_KEY แล้วเรียก mage.run พร้อม id ของโมเดลและค่ากำหนด ก็จะได้ภาพ วิดีโอ หรือเสียงที่เสร็จแล้วจากโมเดลใดก็ได้ใน 28 โมเดล ใช้งานได้บน Node.js 20.19 ขึ้นไป หรือรันไทม์ฝั่งเซิร์ฟเวอร์ใดก็ได้ที่มี fetch และทุกการสร้างจ่ายเป็น Gems

• 20.19+

  Node.js

• 0

  Dependency ตอนรันไทม์

• 28

  โมเดลแบบ typed

• MIT

  โอเพนซอร์ส

การตั้งค่า

ติดตั้ง TypeScript SDK และรันโมเดล

1. 01

   ติดตั้งแพ็กเกจ

   เพิ่ม @mage-space/sdk ลงในโปรเจกต์ของคุณ

   npm install @mage-space/sdk

2. 02

   ตั้งค่า API key

   สร้างคีย์ที่ API → API Keys บน mage.space แล้ว export ไว้ ไคลเอนต์จะอ่านค่าจาก MAGE_API_KEY

   export MAGE_API_KEY="mage_sk_..."

3. 03

   สร้าง

   เรียก run พร้อม id ของโมเดลและค่ากำหนด ระบบจะรอผลลัพธ์แล้วส่งกลับมา โดยไฟล์ผลลัพธ์อยู่ที่ result.url

   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);

ตัวอย่าง

TypeScript SDK ในการใช้งานจริง

ทุกตัวอย่างเริ่มจากไคลเอนต์ที่อ่านค่า MAGE_API_KEY

import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const submitted = await mage.generate('cherry', {
  prompt: 'Waves rolling onto a black sand beach at sunset',
  resolution: '720p',
  duration: '5',
});

const final = await mage.requests.wait(submitted.request_id, {
  timeout: 15 * 60_000,
  onUpdate: (request) => console.log(request.status),
});

import { readFile } from 'node:fs/promises';
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const clip = await mage.uploads.upload(await readFile('clip.mp4'), {
  contentType: 'video/mp4',
});

await mage.run('cherry', {
  prompt: 'Restyle this clip as a watercolor painting',
  videos: [clip.url],
});

import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

await mage.characters.create({
  name: 'Ana',
  handle: 'ana',
  image: 'https://example.com/ana.png',
});

await mage.run('mango', { prompt: '@ana walking through a night market' });

import Mage, { MageAPIError, MageGenerationError } from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

try {
  await mage.run('mango', { prompt: 'A lighthouse at night' });
} catch (error) {
  if (error instanceof MageAPIError && error.code === 'insufficient_gems') {
    // Top up Gems, then try again.
  } else if (error instanceof MageGenerationError) {
    console.log('No output:', error.code);
  } else {
    throw error;
  }
}

ทำไมต้องใช้ SDK

สิ่งที่ SDK จัดการให้คุณ

เอกสารอ้างอิง

TypeScript SDK โดยสรุป

เมธอดชุดเดียวกันใช้ได้กับทุกโมเดล โดยโมเดลคืออาร์กิวเมนต์แรก

โมเดล

เริ่มต้นกับโมเดลเหล่านี้

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

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

เริ่มสร้างสรรค์ด้วย Mage

หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง

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

• Mage SDK
• Mage Python SDK
• Mage สำหรับ ComfyUI
• @mage-space/sdk บน npm
• โมเดล API ทั้งหมด
• เอกสาร API