Bir bakışta
Guava API, Guava ve diğer 4 varyantı Mage üzerinden POST https://api.mage.space/v1/guava/generate adresinde çalıştırır. Varsayılan ayarlarla bir istek 37 Gems (yaklaşık 0,037 $) tutar, abonelik gerekmez. Guava, kayıtlı karakterleri ve referansları istemde @handle ile alır.
Görsel
Çıktı
5
Varyantlar
37
Görsel başına Gems, varsayılan
$0.037
Yaklaşık, USD
Genel bakış
Guava API ne yapar?
Fotogerçekçi model ailemiz; gerçeğe uygun cilt, kumaş ve ışıkla portre, moda ve ürün çekimleri için. Referansları veya Characters'ı kabul eder, 2K'ya kadar.
Mage'in fotogerçekçilik ailesi: fotoğraf gibi görünen portreler, moda ve ürün çekimleri için, referans görsellerle birlikte. Güncel ikili Guava 2 ve Guava 2 Pro.
Girdi olarak image, additional_images kabul eder.
Hızlı başlangıç
Guava API'sini çağır
MAGE_API_KEY'i ayarla, /guava/generate adresine gönder ve istek tamamlanana kadar status_url adresini yokla.
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"])Modeller
Guava model_id değerleri
Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.
| model_id | Ad | Varsayılan |
|---|---|---|
| guava | Guava | Evet |
| guava-pro | Guava Pro | |
| guava-pro-v1-5 | Guava Pro 1.5 | |
| guava-2 | Guava 2 | |
| guava-2-pro | Guava 2 Pro |
Seçenekler
Guava parametreleri
Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.
| Alan | Değerler |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Girdiler
Guava'nın kabul ettiği medya girdileri
Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.
| Alan | Rol |
|---|---|
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
Daha fazla görsel modeli
Mage'deki diğer görsel üretim API'leri
Görsel · 20 Gem'den başlayan fiyatlarla
HiDream API
Hızlı ve çok yönlü, negatif prompt desteğiyle
Görsel · 20 Gem'den başlayan fiyatlarla
Krea 2 API
Saniyeler içinde muhteşem estetik
Görsel · 135 Gem'den başlayan fiyatlarla
Mango API
Amiral gemisi görsel model ailemiz
Görsel · 68 Gem'den başlayan fiyatlarla
Nano Banana 2 API
Net, okunaklı metin, 4K'ya kadar
Görsel · 15 Gems'ten başlayan fiyatlarla
SDXL Plus API
Yüzleri ve elleri düzeltilmiş SDXL
Görsel · 10 Gems'ten başlayan fiyatlarla
Stable Diffusion v1.5 API
Bütçe dostu klasik
SSS
Sık sorulan sorular
Guava API'sinin maliyeti ne kadar?
Varsayılan ayarlarla (Guava) bir Guava isteği 37 Gems, yani yaklaşık 0,037 $ tutar. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta bildirilir. Başarısız olan üretimin ücreti iade edilir; Mage'in içerik politikası nedeniyle engellenen üretimin ücreti ise iade edilmez.
Guava API uç noktası nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/guava/generate. Yanıt, sonucu yoklamak için bir status_url içerir.
Hangi Guava modellerini çağırabilirim?
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Varsayılan model Guava.
Guava referans görsellerini veya karakterleri destekliyor mu?
Guava image ve additional_images girdilerini kabul eder. Kayıtlı karakterleri ve referansları istemde @handle ile alır.
Guava'yı Claude veya ChatGPT'den kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Guava'yı adıyla iste. Asistanın seçenekleri get_model ile okur ve üretmeden önce fiyatı söyler.
Guava sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.