Le SDK TypeScript de Mage

En un coup d’œil

Le SDK TypeScript de Mage est le client officiel et open source de l’API Mage, publié sous le nom @mage-space/sdk. Installe-le avec « npm install @mage-space/sdk », définis MAGE_API_KEY, puis appelle mage.run avec un identifiant de modèle et une configuration pour obtenir des images, des vidéos ou de l’audio avec l’un des 28 modèles. Il fonctionne sur Node.js 20.19 ou version ultérieure, ou sur tout environnement serveur avec fetch, et chaque génération se paie en Gems.

• 20.19+

  Node.js

• 0

  Dépendances d’exécution

• 28

  Modèles typés

• MIT

  Open source

Configuration

Installe le SDK TypeScript et lance un modèle

1. 01

   Installer le paquet

   Ajoute @mage-space/sdk à ton projet.

   npm install @mage-space/sdk

2. 02

   Définir ta clé d’API

   Crée une clé dans API → API Keys sur mage.space et exporte-la. Le client lit MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Générer

   Appelle run avec un identifiant de modèle et sa configuration. Il attend le résultat et le renvoie ; le fichier généré se trouve dans 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);

Exemples

Le SDK TypeScript en pratique

Chaque exemple part d’un client qui lit 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;
  }
}

Pourquoi le SDK

Ce que le SDK gère pour toi

Référence

Le SDK TypeScript en un coup d’œil

Les mêmes méthodes couvrent tous les modèles ; le modèle est le premier argument.

Modèles

Commence avec ces modèles

FAQ

Questions fréquentes

Lance-toi avec Mage

Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.

À voir aussi

• SDK Mage
• SDK Python de Mage
• Mage pour ComfyUI
• @mage-space/sdk sur npm
• Tous les modèles de l'API
• Documentation de l'API