Mage TypeScript SDK

एक नज़र में

Mage TypeScript SDK, Mage API का आधिकारिक ओपन-सोर्स क्लाइंट है, जो @mage-space/sdk नाम से प्रकाशित है। "npm install @mage-space/sdk" से इंस्टॉल करें, MAGE_API_KEY सेट करें और मॉडल id व कॉन्फ़िग के साथ mage.run कॉल करें, तो 28 में से किसी भी मॉडल से तैयार इमेज, वीडियो या ऑडियो मिल जाता है। यह Node.js 20.19 या उसके बाद के वर्शन पर, या fetch वाले किसी भी सर्वर रनटाइम पर चलता है, और हर जनरेशन का भुगतान Gems में होता है।

• 20.19+

  Node.js

• 0

  रनटाइम डिपेंडेंसी

• 28

  टाइप्ड मॉडल

• MIT

  ओपन सोर्स

सेटअप

TypeScript SDK इंस्टॉल करें और मॉडल चलाएँ

1. 01

   पैकेज इंस्टॉल करें

   अपने प्रोजेक्ट में @mage-space/sdk जोड़ें।

   npm install @mage-space/sdk

2. 02

   अपनी API key सेट करें

   mage.space पर API → API Keys में key बनाएँ और उसे export करें। क्लाइंट MAGE_API_KEY पढ़ता है।

   export MAGE_API_KEY="mage_sk_..."

3. 03

   जनरेट करें

   मॉडल id और उसके कॉन्फ़िग के साथ run कॉल करें। यह नतीजे का इंतज़ार करके उसे लौटाता है; आउटपुट 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 SDKs
• Mage Python SDK
• ComfyUI के लिए Mage
• npm पर @mage-space/sdk
• सभी API मॉडल
• API डॉक्यूमेंटेशन