API Mage · Modèle d'image

API Mango

Notre famille d'images phare

Obtenir une clé d'APIEssayer Mango dans le playground
POST https://api.mage.space/v1/mango/generate

En un coup d’œil

L'API Mango exécute Mango 3 et 4 autres variantes via Mage à l'adresse POST https://api.mage.space/v1/mango/generate. Une requête avec les réglages par défaut coûte 135 Gems (environ 0,135 $), sans abonnement. Mango accepte les personnages enregistrés et les références par @handle dans le prompt.

Présentation

Ce que fait l'API Mango

Notre famille de modèles d'image pour des personnages cohérents, des retouches précises et des scènes fusionnant de nombreuses références ou des Characters. Mango 3 est le modèle principal ; Mango 3 Turbo est le plus rapide et le moins cher, et Mango 3S atteint la 3K.

La famille d'images phare de Mage, pour des personnages cohérents, des retouches précises et des scènes fusionnant de nombreuses références. Mango 3 (`mango-v3`) est le modèle actuel ; Mango 3 Turbo (`mango-v3-turbo`) est le plus rapide et le moins cher, et Mango 3S (`mango-v3s`) atteint la 3K.

Il accepte image et additional_images en entrée.

Démarrage rapide

Appeler l'API Mango

Définissez MAGE_API_KEY, envoyez la requête à /mango/generate, puis interrogez status_url jusqu'à ce que la requête soit terminée.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v3"
}' | 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('mango', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'mango-v3',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("mango", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "mango-v3",
})

print(request["result"]["url"])

Modèles

Valeurs de model_id pour Mango

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

model_idNomPar défaut
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3Oui
mango-v3-turboMango 3 Turbo

Options

Paramètres de Mango

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, 3K, 4K

Entrées

Médias acceptés en entrée par Mango

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 68 Gems

API Nano Banana 2

Texte net et lisible, jusqu'en 4K

Image · à partir de 15 Gems

API SDXL Plus

SDXL avec visages et mains corrigés

Image · à partir de 10 Gems

API Stable Diffusion v1.5

Le classique, à petit prix

Image · à partir de 10 Gems

API Stable Diffusion v3.5 Large

Le Stable Diffusion qui comprend le mieux tes prompts

Image · à partir de 10 Gems

API Stable Diffusion XL

SDXL optimisé pour le photoréalisme

Image · à partir de 10 Gems

API Z-Image

Le modèle d'image le plus rapide de Mage

FAQ

Questions fréquentes

Combien coûte l'API Mango ?

Une requête Mango avec les réglages par défaut (Mango 3) coûte 135 Gems, soit environ 0,135 $. 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 ; une génération bloquée par la politique de contenu de Mage ne l'est pas.

Quel est le endpoint de l'API Mango ?

POST https://api.mage.space/v1/mango/generate avec un en-tête Authorization: Bearer contenant votre clé API Mage. La réponse inclut une status_url à interroger pour obtenir le résultat.

Quels modèles Mango puis-je appeler ?

mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Le modèle par défaut est Mango 3.

Mango accepte-t-il des images de référence ou des personnages ?

Mango accepte image et additional_images. Mango accepte les personnages enregistrés et les références par @handle dans le prompt.

Puis-je utiliser Mango depuis Claude ou ChatGPT ?

Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor, et demande Mango par son nom. Ton assistant lit ses options avec get_model et t'indique le prix avant de générer.

Combien de temps les résultats Mango 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.

Obtenir une clé d'APIEssayer Mango dans le playground

À voir aussi