Mage API · Model gambar

API Guava

Fotorealisme yang tampak seperti foto asli

Dapatkan kunci APICoba Guava di playground
POST https://api.mage.space/v1/guava/generate

Sekilas info

API Guava menjalankan Guava dan 4 varian lainnya lewat Mage di POST https://api.mage.space/v1/guava/generate. Satu permintaan dengan pengaturan default berharga 37 Gems (sekitar $0,037), tanpa langganan. Guava bisa memakai karakter dan referensi yang tersimpan lewat @handle di prompt.

Ringkasan

Fungsi API Guava

Keluarga model fotorealisme kami, untuk potret, fashion, dan foto produk dengan kulit, kain, dan cahaya yang terlihat nyata. Mendukung referensi atau Characters, hingga 2K.

Keluarga model fotorealisme dari Mage, untuk potret, fashion, dan foto produk yang terlihat seperti foto asli, dengan gambar referensi. Guava 2 dan Guava 2 Pro adalah pasangan terbaru saat ini.

Menerima image dan additional_images sebagai input.

Mulai cepat

Panggil API Guava

Setel MAGE_API_KEY, kirim ke /guava/generate, lalu polling status_url sampai permintaan selesai.

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

Model

Nilai model_id Guava

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

model_idNamaDefault
guavaGuavaYa
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Opsi

Parameter Guava

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

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

Input

Input media yang diterima Guava

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

KolomPeran
imageGambar referensi.
additional_imagesGambar referensi tambahan.

Model gambar lainnya

API pembuat gambar lainnya di Mage

Gambar · mulai 20 Gems

HiDream API

Cepat dan serbaguna, dengan negative prompt

Gambar · mulai 20 Gems

Krea 2 API

Estetika memukau dalam hitungan detik

Gambar · mulai dari 135 Gems

Mango API

Keluarga model gambar andalan kami

Gambar · mulai dari 68 Gems

Nano Banana 2 API

Teks tajam dan mudah dibaca, hingga 4K

Gambar · mulai dari 15 Gems

API SDXL Plus

SDXL dengan wajah dan tangan yang sudah diperbaiki

Gambar · mulai dari 10 Gems

API Stable Diffusion v1.5

Si klasik yang hemat biaya

FAQ

Pertanyaan yang sering diajukan

Berapa biaya API Guava?

Satu permintaan Guava dengan pengaturan default (Guava) berharga 37 Gems, sekitar $0,037. Resolusi, durasi, dan varian lain akan mengubah harganya; respons menampilkan biaya pastinya. Generasi yang gagal akan dikembalikan Gems-nya; generasi yang diblokir oleh kebijakan konten Mage tidak.

Apa endpoint API Guava?

POST https://api.mage.space/v1/guava/generate dengan header Authorization: Bearer yang berisi kunci API Mage kamu. Respons menyertakan status_url untuk di-polling guna mendapatkan hasilnya.

Model Guava apa saja yang bisa kupanggil?

guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Defaultnya adalah Guava.

Apakah Guava mendukung gambar referensi atau karakter?

Guava menerima image, additional_images. Guava menerima karakter dan referensi yang tersimpan lewat @handle di prompt.

Bisakah aku memakai Guava dari Claude atau ChatGPT?

Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Guava dengan menyebut namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harga sebelum membuat.

Berapa lama hasil Guava disimpan?

Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

Dapatkan kunci APICoba Guava di playground

Terkait