Das Mage TypeScript-SDK

Auf einen Blick

Das Mage TypeScript-SDK ist der offizielle Open-Source-Client für die Mage API und wird als @mage-space/sdk veröffentlicht. Installiere es mit "npm install @mage-space/sdk", setze MAGE_API_KEY und rufe mage.run mit einer Modell-ID und einer Konfiguration auf, um fertige Bilder, Videos oder Audio von einem von 28 Modellen zu erhalten. Es läuft mit Node.js 20.19 oder neuer oder in jeder Server-Laufzeitumgebung mit fetch, und jede Generierung wird in Gems bezahlt.

• 20.19+

  Node.js

• 0

  Laufzeitabhängigkeiten

• 28

  Typisierte Modelle

• MIT

  Open Source

Einrichtung

TypeScript-SDK installieren und ein Modell ausführen

1. 01

   Paket installieren

   Füge @mage-space/sdk zu deinem Projekt hinzu.

   npm install @mage-space/sdk

2. 02

   API-Key festlegen

   Erstelle auf mage.space unter API → API Keys einen Key und exportiere ihn. Der Client liest MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Generieren

   Rufe run mit einer Modell-ID und der zugehörigen Konfiguration auf. Es wartet auf das Ergebnis und gibt es zurück; die Ausgabe findest du unter 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);

Beispiele

Das TypeScript-SDK in der Praxis

Jedes Beispiel beginnt mit einem Client, der MAGE_API_KEY liest.

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

Warum das SDK

Was das SDK für dich übernimmt

Referenz

Das TypeScript-SDK im Überblick

Dieselben Methoden decken jedes Modell ab; das Modell ist das erste Argument.

Modelle

Starte mit diesen Modellen

FAQ

Häufig gestellte Fragen

Starte jetzt mit Mage

Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.

Ähnliche Inhalte

• Mage SDKs
• Mage Python-SDK
• Mage für ComfyUI
• @mage-space/sdk auf npm
• Alle API-Modelle
• API-Dokumentation