Treci la conținut

Mage API · Model de imagine

API Guava

Fotorealism care trece drept fotografie

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

Pe scurt

API-ul Guava rulează Guava și alte 4 variante prin Mage la POST https://api.mage.space/v1/guava/generate. O cerere cu setările implicite costă 37 Gems (aproximativ 0,037 $), fără abonament. Guava folosește personaje și referințe salvate, prin @handle în prompt.

  • ImagineRezultat
  • 5Variante
  • 37Gems per imagine, implicit
  • $0.037Aproximativ, în USD

Prezentare generală

Ce face API-ul Guava

Familia noastră de fotorealism, pentru portrete, modă și fotografii de produs, cu piele, țesături și lumină fidele realității. Acceptă References sau Characters, până la 2K.

Familia Mage pentru fotorealism, pentru portrete, modă și fotografii de produs care par fotografii adevărate, cu imagini de referință. Guava 2 și Guava 2 Pro sunt perechea actuală.

Acceptă ca intrări image, additional_images.

Pornire rapidă

Apelează API-ul Guava

Setează MAGE_API_KEY, trimite cererea la /guava/generate și interoghează status_url până când cererea se finalizează.

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"])

Modele

Valori model_id pentru Guava

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
guavaGuavaDa
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Opțiuni

Parametri Guava

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K

Intrări

Fișiere media acceptate de Guava

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

  • Imagine · de la 20 Gems

    API HiDream

    Rapid și versatil, cu prompturi negative

  • Imagine · de la 20 Gems

    API Krea 2

    Estetică spectaculoasă în câteva secunde

  • Imagine · de la 135 de Gems

    API Mango

    Familia noastră principală de modele de imagine

  • Imagine · de la 51 de Gems

    API Nano Banana 2

    Text clar și lizibil, până la 4K

  • Imagine · de la 15 Gems

    API SDXL Plus

    SDXL cu fețe și mâini corectate

  • Imagine · de la 10 Gems

    API Stable Diffusion v1.5

    Clasicul, la preț mic

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Guava?
O cerere Guava cu setările implicite (Guava) costă 37 Gems, adică aproximativ $0.037. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Guava?
POST https://api.mage.space/v1/guava/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru rezultat.
Ce modele Guava pot apela?
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Implicit este Guava.
Acceptă Guava imagini de referință sau personaje?
Guava acceptă image, additional_images. Guava folosește personaje salvate și referințe prin @handle în prompt.
Pot folosi Guava din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Guava ppe nume. Asistentul tău își citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Guava?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.