Passer au contenu

API Mage · Modèle d'image

API Guava

Un photoréalisme digne d'une vraie photo

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

En un coup d’œil

L'API Guava fait tourner Guava et 4 autres variantes via Mage sur POST https://api.mage.space/v1/guava/generate. Une requête avec les réglages par défaut coûte 37 Gems (environ 0,037 $), sans abonnement. Guava prend en charge les personnages et références enregistrés via @handle dans le prompt.

  • ImageSortie
  • 5Variantes
  • 37Gems par image, par défaut
  • $0.037Environ, en USD

Présentation

Ce que fait l'API Guava

Notre famille photoréaliste, pour les portraits, la mode et les photos produit, avec une peau, des tissus et une lumière criants de vérité. Accepte des références ou des Characters, jusqu'à 2K.

La famille photoréaliste de Mage, pour des portraits, de la mode et des photos de produits qu'on prendrait pour de vraies photos, avec des images de référence. Guava 2 et Guava 2 Pro forment le duo actuel.

Il accepte image et additional_images en entrée.

Démarrage rapide

Appeler l'API Guava

Définis MAGE_API_KEY, envoie ta requête à /guava/generate, puis interroge status_url jusqu'à ce qu'elle soit terminée.

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

Modèles

Valeurs model_id de Guava

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

model_idNomPar défaut
guavaGuavaOui
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Options

Paramètres de Guava

Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.

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

Entrées

Médias acceptés par Guava

Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.

ChampRôle
imageL'image de référence.
additional_imagesImages de référence supplémentaires.

Autres modèles d'image

Autres API de génération d'images sur Mage

  • Image · à partir de 20 Gems

    API HiDream

    Rapide et polyvalent, avec prompts négatifs

  • Image · à partir de 20 Gems

    Krea 2 API

    Une esthétique superbe en quelques secondes

  • Image · à partir de 42 Gems

    API Mango

    Notre famille d'images phare

  • Image · à partir de 15 Gems

    API MiniMax H3 Image

    Images natives de 16 mégapixels, poids ouverts

  • Image · à partir de 25 Gems

    API MOSS-Image

    Prompts longs et texte bilingue, poids ouverts

  • Image · à partir de 51 Gems

    API Nano Banana 2

    Texte net et lisible, jusqu'en 4K

FAQ

Questions fréquentes

Combien coûte l'API Guava ?
Une requête Guava avec les réglages par défaut (Guava) coûte 37 Gems, soit environ 0,037 $. Les autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; celle bloquée par la politique de contenu de Mage ne l'est pas.
Quel est le endpoint de l'API Guava ?
POST https://api.mage.space/v1/guava/generate avec un en-tête Authorization: Bearer contenant ta clé d'API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles Guava puis-je appeler ?
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Le modèle par défaut est Guava.
Guava prend-il en charge les images de référence ou les personnages ?
Guava accepte image, additional_images. Guava prend en charge les personnages et références enregistrés via @handle dans le prompt.
Puis-je utiliser Guava depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Guava par son nom. Ton assistant lit ses options avec get_model et indique le prix avant de générer.
Combien de temps les résultats Guava sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

Lance-toi avec Mage

Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.

CharactersCommunauté