Auf einen Blick
Die Guava API führt Guava und 4 weitere Varianten über Mage aus: POST https://api.mage.space/v1/guava/generate. Eine Anfrage mit den Standardeinstellungen kostet 37 Gems (etwa 0,037 $), ohne Abo. Gespeicherte Characters und References nimmt Guava per @handle im Prompt entgegen.
Bild
Ausgabe
5
Varianten
37
Gems pro Bild, Standard
$0.037
Ca. in USD
Überblick
Was die Guava API kann
Unsere Fotorealismus-Familie für Porträts, Mode und Produktaufnahmen mit lebensechter Haut, Stoffen und Licht. Nimmt References oder Characters entgegen, bis zu 2K.
Die Fotorealismus-Familie von Mage für Porträts, Mode und Produktfotos, die als echte Fotos durchgehen – mit Referenzbildern. Guava 2 und Guava 2 Pro sind das aktuelle Duo.
Es akzeptiert image und additional_images als Eingaben.
Schnellstart
Die Guava API aufrufen
Setze MAGE_API_KEY, sende die Anfrage an /guava/generate und frage status_url ab, bis die Anfrage abgeschlossen ist.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/guava/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": "guava"
}' | 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('guava', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'guava',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("guava", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "guava",
})
print(request["result"]["url"])Modelle
Guava model_id-Werte
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| guava | Guava | Ja |
| guava-pro | Guava Pro | |
| guava-pro-v1-5 | Guava Pro 1.5 | |
| guava-2 | Guava 2 | |
| guava-2-pro | Guava 2 Pro |
Optionen
Guava-Parameter
Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.
| Feld | Werte |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Eingaben
Medieneingaben, die Guava akzeptiert
Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.
| Feld | Rolle |
|---|---|
| image | Das Referenzbild. |
| additional_images | Weitere Referenzbilder. |
Weitere Bildmodelle
Weitere APIs zur Bildgenerierung auf Mage
Bild · ab 20 Gems
HiDream API
Schnell und vielseitig, mit Negativ-Prompts
Bild · ab 20 Gems
Krea 2 API
Beeindruckende Ästhetik in Sekunden
Bild · ab 135 Gems
Mango API
Unsere Flaggschiff-Bildfamilie
Bild · ab 68 Gems
Nano Banana 2 API
Gestochen scharfer, lesbarer Text, bis zu 4K
Bild · ab 15 Gems
SDXL Plus API
SDXL mit korrigierten Gesichtern und Händen
Bild · ab 10 Gems
Stable Diffusion v1.5 API
Der Klassiker für kleines Budget
FAQ
Häufig gestellte Fragen
Wie viel kostet die Guava API?
Eine Guava-Anfrage mit den Standardeinstellungen (Guava) kostet 37 Gems, etwa 0,037 $. Andere Auflösungen, Dauern und Varianten verändern den Preis; die Antwort nennt den genauen Betrag. Eine fehlgeschlagene Generierung wird erstattet; eine, die von der Inhaltsrichtlinie von Mage blockiert wird, nicht.
Wie lautet der Endpunkt der Guava API?
POST https://api.mage.space/v1/guava/generate mit einem Authorization: Bearer-Header, der deinen Mage-API-Schlüssel enthält. Die Antwort enthält eine status_url, die du für das Ergebnis abfragst.
Welche Guava-Modelle kann ich aufrufen?
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Standard ist Guava.
Unterstützt Guava Referenzbilder oder Characters?
Guava akzeptiert image und additional_images. Guava nutzt gespeicherte Characters und References per @handle im Prompt.
Kann ich Guava über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage-MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frag direkt nach Guava. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er generiert.
Wie lange werden Guava-Ergebnisse gespeichert?
Ergebnisse und Eingaben werden 30 Tage lang gespeichert. Lade alles, was du behalten möchtest, in deinen eigenen Speicher herunter.
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.