In één oogopslag
De Guava API draait Guava en 4 andere varianten via Mage op POST https://api.mage.space/v1/guava/generate. Een verzoek met de standaardinstellingen kost 37 Gems (ongeveer $0,037), zonder abonnement. Guava gebruikt opgeslagen personages en referenties via @handle in de prompt.
Afbeelding
Uitvoer
5
Varianten
37
Gems per afbeelding, standaard
$0.037
Ongeveer, in USD
Overzicht
Wat de Guava API doet
Onze fotorealistische modelfamilie, voor portretten, mode en productfoto's met levensechte huid, stof en licht. Werkt met referenties of Characters, tot 2K.
De fotorealisme-familie van Mage, voor portretten, mode en productfoto's die voor echte foto's kunnen doorgaan, met referentieafbeeldingen. Guava 2 en Guava 2 Pro vormen het huidige duo.
Accepteert image, additional_images als invoer.
Snel starten
Roep de Guava API aan
Stel MAGE_API_KEY in, verstuur je verzoek naar /guava/generate en vraag status_url steeds opnieuw op tot het verzoek is voltooid.
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"])Modellen
model_id-waarden voor Guava
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| 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 |
Opties
Guava-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Invoer
Media-invoer die Guava accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| image | De referentieafbeelding. |
| additional_images | Extra referentieafbeeldingen. |
Meer beeldmodellen
Andere API's voor beeldgeneratie op Mage
Afbeelding · vanaf 20 Gems
HiDream API
Snel en veelzijdig, met negatieve prompts
Afbeelding · vanaf 20 Gems
Krea 2 API
Prachtige esthetiek in enkele seconden
Afbeelding · vanaf 135 Gems
Mango API
Onze vlaggenschip-afbeeldingsfamilie
Afbeelding · vanaf 68 Gems
Nano Banana 2 API
Scherpe, leesbare tekst, tot 4K
Afbeelding · vanaf 15 Gems
SDXL Plus API
SDXL met gerepareerde gezichten en handen
Afbeelding · vanaf 10 Gems
Stable Diffusion v1.5 API
De klassieker, voor een klein budget
FAQ
Veelgestelde vragen
Wat kost de Guava API?
Een Guava-verzoek met de standaardinstellingen (Guava) kost 37 Gems, ongeveer $0,037. Andere resoluties, duur en varianten veranderen de prijs; in het antwoord staat het exacte bedrag. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de Guava API?
POST https://api.mage.space/v1/guava/generate met een Authorization: Bearer-header met je Mage API-sleutel. Het antwoord bevat een status_url waarmee je het resultaat kunt opvragen.
Welke Guava-modellen kan ik aanroepen?
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). De standaard is Guava.
Ondersteunt Guava referentieafbeeldingen of Characters?
Guava accepteert image en additional_images. Guava ondersteunt opgeslagen Characters en References via @handle in de prompt.
Kan ik Guava gebruiken vanuit Claude of ChatGPT?
Ja. Koppel de Mage MCP-server aan Claude, ChatGPT, Claude Code, Grok of Cursor en vraag om Guava bij naam. Je assistent leest de opties uit met get_model en noemt de prijs voordat er iets wordt gegenereerd.
Hoe lang worden Guava-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.