Mage API · Bildgenerierung
Die API zur KI-Bildgenerierung für jedes Modell
Text-zu-Bild, Bildbearbeitung und konsistente Characters mit 18 Modellen, darunter Mages Flaggschiff Mango 4, über einen Schlüssel und ein Guthaben.
POST https://api.mage.space/v1/{model}/generateAuf einen Blick
Die Mage API für Bildgenerierung ist eine REST API unter https://api.mage.space/v1, die 18 Modelle für Text-zu-Bild und Bildbearbeitung ausführt, darunter Mango 4, Guava 2 Pro, GPT Image 2.6, 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.
- 18Bildmodelle
- $0.009Günstigster Standard, pro Bild
- 20Parallele Generierungen
- $0Monatliche 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.
| Modell | Ideal für | model_id-Werte | Standardpreis |
|---|---|---|---|
| Anima | Speziell für Anime entwickelt | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-Weights-Modell auf Basis von Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Lange Prompts und Bearbeitungen mit mehreren Referenzen | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Präzise Prompts und lesbarer Text | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine in zwei Stufen | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Fotorealismus, der als echtes Foto durchgeht | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Schnell und vielseitig, mit Negative Prompts | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Traumhafte Ästhetik in Sekunden | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Unsere Flaggschiff-Bildfamilie | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Native 16-Megapixel-Bilder, Open Weights | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Lange Prompts und zweisprachiger Text, offene Gewichte | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Gestochen scharfer, lesbarer Text, bis zu 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL mit korrigierten Gesichtern und Händen | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, mit strengem Filter | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | Der Klassiker fürs kleine Budget | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Das Stable Diffusion, das am besten auf Prompts hört | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | Auf Fotorealismus getrimmtes SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Das schnellste Bildmodell auf Mage | z-image-turbo | 10 Gems ($0.01) |
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.
cURL
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"TypeScript
// 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);Python
# 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.
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.
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.
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
Ein Schlüssel, alle Modelle
37 Bild-, Video- und Audiomodelle hinter einer REST-API und einem Gems-Guthaben. Wechsle das Modell, indem du den URL-Pfad änderst.
Zahlung pro Generierung
Kein Abo und kein Mindestumsatz. Du kaufst Gems, und jede Anfrage kostet ihren angegebenen Preis. Eine fehlgeschlagene Generierung wird erstattet, es sei denn, die Inhaltsrichtlinie von Mage hat sie blockiert.
Sichere Wiederholungen
Mit Idempotency-Keys liefert ein erneut gesendeter Request die ursprüngliche Anfrage zurück, ohne erneut abzurechnen.
Konsistente Charaktere
Speichere einen Charakter oder eine Referenz einmal und schreibe dann @handle in einen beliebigen Prompt, um sie mit jedem unterstützten Modell zu verwenden.
Große Eingaben
Sende Bild-, Video- und Audioeingaben als URLs oder Data-URLs oder lade Dateien bis 100 MB über einen signierten Upload hoch.
20 Generierungen gleichzeitig
Jedes Konto kann 20 Generierungen gleichzeitig ausführen, und das Limit lässt sich für deinen Anwendungsfall erhöhen. Abgelehnte Anfragen werden nie berechnet.
Anwendungsfälle
Was Entwickler mit der Bild-API bauen
Produkt- und Marketingbilder
Erstelle Produktfotos, Anzeigenvarianten und Social-Media-Posts auf Abruf, mit gut lesbarem Text von GPT Image 2.6 oder Nano Banana 2.
Konsistente Charaktere
Speichere einen Charakter einmal und behalte dasselbe Gesicht in einer ganzen Serie – mit Mango 4, Guava 2 Pro und anderen Modellen, die @handle-Erwähnungen unterstützen.
Pipelines für Bildbearbeitung
Sende ein Ausgangsbild mit einer Anweisung, um genau das zu ändern, was du willst, und alles andere unverändert zu lassen.
Apps und Spiele
Erzeuge Avatare, Sticker, Karten und Szenen direkt in deinem Produkt, ohne eine einzige GPU zu hosten.
Fotorealistische Porträts
Guava 2 Pro rendert Porträts, Fashion- und Lifestyle-Aufnahmen mit lebensechter Haut, realistischen Stoffen und natürlichem Licht.
Schnelle Entwürfe in großem Stil
Z-Image Turbo und Krea 2 halten die Kosten niedrig – ideal für Thumbnails in großen Mengen und erste Durchläufe.
FAQ
Häufig gestellte Fragen
Was ist die beste API zur KI-Bildgenerierung?
Unterstützt die Bild-API Bildbearbeitung und Referenzbilder?
Welche Auflösungen unterstützt die Bild-API?
Was kostet die Mage API?
Brauche ich eine Mage-Mitgliedschaft, um die API zu nutzen?
Kann ich API-Ergebnisse kommerziell nutzen?
Welche Rate Limits gibt es?
Kann mein KI-Agent die Mage API nutzen?
Gibt es ein SDK für die Mage API?
Ich nutze bereits eine andere Generierungs-API. Was muss ich ändern?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.