Mage API · Model obrazu

API Guava

Fotorealizm nie do odróżnienia od zdjęcia

Zdobądź klucz APIWypróbuj Guava w playgroundzie
POST https://api.mage.space/v1/guava/generate

W skrócie

API Guava uruchamia przez Mage model Guava i 4 inne warianty pod adresem POST https://api.mage.space/v1/guava/generate. Żądanie z ustawieniami domyślnymi kosztuje 37 Gems (około 0,037 USD), bez subskrypcji. Guava obsługuje zapisane postacie i referencje przez @handle w prompcie.

Przegląd

Co robi API Guava

Nasza rodzina modeli fotorealistycznych do portretów, mody i zdjęć produktowych z wiernie oddaną skórą, tkaninami i światłem. Obsługuje referencje lub Characters, do 2K.

Rodzina modeli Mage do fotorealizmu: portrety, moda i zdjęcia produktowe, które wyglądają jak prawdziwe fotografie, z obsługą obrazów referencyjnych. Obecnie dostępna jest para Guava 2 i Guava 2 Pro.

Przyjmuje dane wejściowe: image, additional_images.

Szybki start

Jak wywołać Guava API

Ustaw MAGE_API_KEY, wyślij zapytanie na /guava/generate i sprawdzaj status_url, aż zapytanie zostanie zrealizowane.

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

Wartości model_id dla Guava

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
guavaGuavaTak
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Opcje

Parametry Guava

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K

Dane wejściowe

Pliki wejściowe obsługiwane przez Guava

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.

Więcej modeli obrazów

Inne API do generowania obrazów w Mage

Obraz · od 20 Gems

HiDream API

Szybki i wszechstronny, z negatywnymi promptami

Obraz · od 20 Gems

Krea 2 API

Zachwycająca estetyka w kilka sekund

Obraz · od 135 Gems

Mango API

Nasza flagowa rodzina modeli obrazu

Obraz · od 68 Gems

Nano Banana 2 API

Wyraźny, czytelny tekst, do 4K

Obraz · od 15 Gems

API SDXL Plus

SDXL z poprawionymi twarzami i dłońmi

Obraz · od 10 Gems

Stable Diffusion v1.5 API

Klasyk w przystępnej cenie

FAQ

Najczęściej zadawane pytania

Ile kosztuje Guava API?

Zapytanie do Guava z ustawieniami domyślnymi (Guava) kosztuje 37 Gems, czyli około 0,037 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę, a dokładną opłatę podaje odpowiedź. Za nieudaną generację zwracamy koszt, ale nie za taką, którą zablokuje polityka treści Mage.

Jaki jest endpoint Guava API?

POST https://api.mage.space/v1/guava/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który sprawdzasz, aby pobrać wynik.

Które modele Guava mogę wywołać?

guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Domyślny to Guava.

Czy Guava obsługuje obrazy referencyjne lub postacie?

Guava przyjmuje image, additional_images. Zapisane postacie i referencje wywołasz przez @handle w prompcie.

Czy mogę używać Guava z poziomu Claude lub ChatGPT?

Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Guava po nazwie. Asystent sprawdzi opcje modelu przez get_model i poda cenę przed generowaniem.

Jak długo przechowywane są wyniki Guava?

Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Zdobądź klucz APIWypróbuj Guava w playgroundzie

Powiązane