Μετάβαση στο περιεχόμενο

Mage API · Μοντέλο εικόνας

Guava API

Φωτορεαλισμός που περνά για φωτογραφία

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

Με μια ματιά

Το Guava API τρέχει το Guava και άλλες 4 παραλλαγές μέσω του Mage στο POST https://api.mage.space/v1/guava/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 37 Gems (περίπου $0.037), χωρίς συνδρομή. Το Guava δέχεται αποθηκευμένους χαρακτήρες και αναφορές μέσω @handle στο prompt.

  • ΕικόναΈξοδος
  • 5Παραλλαγές
  • 37Gems ανά εικόνα, προεπιλογή
  • $0.037Περίπου, σε USD

Επισκόπηση

Τι κάνει το Guava API

Η οικογένειά μας φωτορεαλισμού, για πορτρέτα, μόδα και φωτογραφίες προϊόντων με αληθοφανές δέρμα, ύφασμα και φως. Δέχεται References ή Characters, έως 2K.

Η οικογένεια φωτορεαλισμού του Mage, για πορτρέτα, μόδα και φωτογραφίες προϊόντων που περνούν για πραγματικές φωτογραφίες, με εικόνες αναφοράς. Τα Guava 2 και Guava 2 Pro είναι το τρέχον ζευγάρι.

Δέχεται ως εισόδους τα image, additional_images.

Γρήγορη εκκίνηση

Κάλεσε το Guava API

Όρισε το MAGE_API_KEY, στείλε το αίτημα στο /guava/generate και έλεγχε το status_url μέχρι να ολοκληρωθεί το αίτημα.

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_id για το Guava

Στείλε το model_id για να διαλέξεις παραλλαγή. Ένα αίτημα χωρίς αυτό εκτελεί την προεπιλεγμένη.

model_idΌνομαΠροεπιλογή
guavaGuavaΝαι
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Επιλογές

Παράμετροι του Guava

Οι τιμές που επιτρέπονται σε όλες τις παραλλαγές· μια παραλλαγή μπορεί να προσφέρει λιγότερες. Τα docs αναφέρουν τις επιλογές ανά παραλλαγή.

ΠεδίοΤιμές
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K

Είσοδοι

Είσοδοι πολυμέσων που δέχεται το Guava

Στείλε κάθε αρχείο ως https URL, ως data URL ή ως ανέβασμα έως 100 MB.

ΠεδίοΡόλος
imageΗ εικόνα αναφοράς.
additional_imagesΠρόσθετες εικόνες αναφοράς.

Περισσότερα μοντέλα εικόνας

Άλλα API δημιουργίας εικόνων στο Mage

  • Εικόνα · από 20 Gems

    HiDream API

    Γρήγορο και ευέλικτο, με αρνητικά prompt

  • Εικόνα · από 20 Gems

    Krea 2 API

    Εντυπωσιακή αισθητική σε δευτερόλεπτα

  • Εικόνα · από 135 Gems

    Mango API

    Η κορυφαία οικογένεια μοντέλων εικόνας μας

  • Εικόνα · από 51 Gems

    Nano Banana 2 API

    Καθαρό, ευανάγνωστο κείμενο, έως 4K

  • Εικόνα · από 15 Gems

    SDXL Plus API

    SDXL με διορθωμένα πρόσωπα και χέρια

  • Εικόνα · από 10 Gems

    Stable Diffusion v1.5 API

    Το κλασικό, σε οικονομική τιμή

Συχνές ερωτήσεις

Συχνές ερωτήσεις

Πόσο κοστίζει το Guava API;
Ένα αίτημα Guava με τις προεπιλεγμένες ρυθμίσεις (Guava) κοστίζει 37 Gems, περίπου $0.037. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απόκριση δείχνει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, γίνεται επιστροφή χρημάτων· αν τη μπλοκάρει η πολιτική περιεχομένου του Mage, δεν γίνεται.
Ποιο είναι το endpoint του Guava API;
POST https://api.mage.space/v1/guava/generate με header Authorization: Bearer που περιέχει το κλειδί API σου για το Mage. Η απόκριση περιλαμβάνει ένα status_url για να ελέγχεις το αποτέλεσμα.
Ποια μοντέλα Guava μπορώ να καλέσω;
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Η προεπιλογή είναι το Guava.
Υποστηρίζει το Guava εικόνες αναφοράς ή χαρακτήρες;
Το Guava δέχεται image, additional_images. Το Guava δέχεται αποθηκευμένους χαρακτήρες και αναφορές μέσω @handle στο prompt.
Μπορώ να χρησιμοποιήσω το Guava από το Claude ή το ChatGPT;
Ναι. Σύνδεσε τον διακομιστή Mage MCP με το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor και ζήτα το Guava με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με get_model και αναφέρει την τιμή πριν δημιουργήσει.
Για πόσο διατηρούνται τα αποτελέσματα του Guava;
Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

Ξεκίνα να δημιουργείς με το Mage

Ένας λογαριασμός, ένα υπόλοιπο Gems, όλα τα μοντέλα. Πληρώνεις μόνο για ό,τι δημιουργείς.