Die API zur KI-Bildgenerierung für jedes Modell

Auf einen Blick

Die Mage API zur Bildgenerierung ist eine REST-API unter https://api.mage.space/v1, die 15 Text-zu-Bild- und Bildbearbeitungsmodelle ausführt, darunter Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 und Krea 2. Du sendest per POST einen Prompt an /{model}/generate, fragst die Anfrage ab und lädst das Bild herunter. Jedes Bild wird in Gems bezahlt, ohne Abo.

• 15

  Bildmodelle

• $0.009

  Günstigster Standard, pro Bild

• 20

  Parallele Generierungen

• $0

  Monatliche Gebühr

Modelle

Alle Bildmodelle in der Mage API

Die Preise gelten pro Generierung, in Gems. 1.000 Gems kosten im Standardpaket 1 $, größere Pakete enthalten Bonus-Gems. Der Preis hängt von Modell, Auflösung und Dauer ab; angezeigt wird der Preis bei Standardeinstellungen, und jede Antwort nennt die genaue Abbuchung in billing.gems_charged. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte nicht.

Schnellstart

Generiere ein Bild mit Anima v1

Setze MAGE_API_KEY, sende die Anfrage ab und frage sie ab, bis sie abgeschlossen ist. Ersetze anima in der URL durch ein beliebiges Modell oben.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "anima-v1"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

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

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

const request = await mage.run('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("anima", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "anima-v1",
})

print(request["result"]["url"])

So funktioniert's

Vom API-Schlüssel zum fertigen Medium in drei Aufrufen

Alle Modelle teilen sich ein Authentifizierungsschema, einen asynchronen Anfrageablauf und dieselben Feldnamen.

1. 01

   API-Schlüssel erstellen

   Melde dich bei Mage an, öffne API → API Keys und erstelle einen Schlüssel. Er beginnt mit mage_sk_ und wird nur einmal angezeigt. Ein Konto kann 10 aktive Schlüssel haben.

2. 02

   Generierung senden

   Sende per POST einen JSON-Body an https://api.mage.space/v1/{model}/generate, mit einem Authorization: Bearer-Header. Die Antwort kommt sofort und enthält eine request_id, einen status und eine status_url. Sende einen Idempotency-Key-Header, damit eine Wiederholung nie doppelt kostet.

3. 03

   Abfragen und herunterladen

   Frage die status_url ab, bis der Status completed, failed oder cancelled ist. Eine abgeschlossene Anfrage enthält result.url mit der Bild-, Video- oder Audiodatei, die 30 Tage lang gespeichert bleibt.

Für den Produktiveinsatz gebaut

Das bekommt jede Anfrage an die Mage API

Anwendungsfälle

Was Entwickler mit der Bild-API bauen

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

• API für KI-Videogenerierung
• API für KI-Audiogenerierung
• Mage MCP-Server
• Mage SDKs
• Mage für ComfyUI
• Alle API-Modelle
• API-Playground
• API-Dokumentation