Mage TypeScript SDK

Bir bakışta

Mage TypeScript SDK, Mage API'nin resmi ve açık kaynaklı istemcisidir ve @mage-space/sdk adıyla yayımlanır. "npm install @mage-space/sdk" ile kur, MAGE_API_KEY değerini ayarla ve bir model kimliği ile yapılandırmayla mage.run çağırarak 28 modelden herhangi birinden hazır görsel, video veya ses al. Node.js 20.19 veya üstünde ya da fetch destekleyen herhangi bir sunucu çalışma ortamında çalışır; her üretim Gems ile ödenir.

• 20.19+

  Node.js

• 0

  Çalışma zamanı bağımlılıkları

• 28

  Tip tanımlı modeller

• MIT

  Açık kaynak

Kurulum

TypeScript SDK'yı kur ve bir model çalıştır

1. 01

   Paketi kur

   @mage-space/sdk paketini projene ekle.

   npm install @mage-space/sdk

2. 02

   API anahtarını ayarla

   mage.space'te API → API Keys bölümünden bir anahtar oluştur ve dışa aktar. İstemci MAGE_API_KEY değerini okur.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Üret

   run fonksiyonunu bir model kimliği ve yapılandırmasıyla çağır. Sonucu bekler ve döndürür; çıktı result.url adresindedir.

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

Örnekler

TypeScript SDK uygulamada

Her örnek, MAGE_API_KEY değerini okuyan bir istemciyle başlar.

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

Neden SDK

SDK senin için neleri halleder

Referans

TypeScript SDK bir bakışta

Aynı yöntemler her modeli kapsar; model ilk argümandır.

Modeller

Bu modellerle başla

SSS

Sık sorulan sorular

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

İlgili

• Mage SDK'ları
• Mage Python SDK
• ComfyUI için Mage
• npm'de @mage-space/sdk
• Tüm API modelleri
• API dokümantasyonu