Ga naar de inhoud

Mage API · Beeldmodel

Guava API

Fotorealisme dat voor een echte foto doorgaat

POST https://api.mage.space/v1/guava/generate

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.

  • AfbeeldingUitvoer
  • 5Varianten
  • 37Gems per afbeelding, standaard
  • $0.037Ongeveer, 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_idNaamStandaard
guavaGuavaJa
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Opties

Guava-parameters

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

VeldWaarden
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K

Invoer

Media-invoer die Guava accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

VeldRol
imageDe referentieafbeelding.
additional_imagesExtra 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 42 Gems

    Mango API

    Onze vlaggenschip-afbeeldingsfamilie

  • Afbeelding · vanaf 15 Gems

    MiniMax H3 Image API

    Native afbeeldingen van 16 megapixel, open weights

  • Afbeelding · vanaf 25 Gems

    MOSS-Image API

    Lange prompts en tweetalige tekst, open weights

  • Afbeelding · vanaf 51 Gems

    Nano Banana 2 API

    Scherpe, leesbare tekst, tot 4K

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.

CharactersCommunity