En un coup d’œil
L'API SDXL Plus exécute SDXL Plus via Mage à l'adresse POST https://api.mage.space/v1/sdxl_plus/generate. Une requête avec les réglages par défaut coûte 15 Gems (environ 0,015 $), sans abonnement. SDXL Plus ne prend pas en charge les mentions @handle.
Image
Sortie
1
Variante
15
Gems par image, par défaut
$0.015
Environ, en USD
Présentation
Ce que fait l'API SDXL Plus
Notre pipeline SDXL haute définition avec correction automatique des visages et des mains. Texte vers image ou à partir d'une image d'entrée ; plus lent que SDXL classique, mais ça vaut le coup.
Le pipeline SDXL haute définition de Mage avec correction automatique des visages et des mains, et une image d'entrée en option.
Il accepte image en entrée.
Démarrage rapide
Appeler l'API SDXL Plus
Définis MAGE_API_KEY, envoie ta requête à /sdxl_plus/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/sdxl_plus/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": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80"
}' | 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('sdxl_plus', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: '6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("sdxl_plus", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80",
})
print(request["result"]["url"])Modèles
Valeurs model_id de SDXL Plus
Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.
| model_id | Nom | Par défaut |
|---|---|---|
| 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | SDXL Plus | Oui |
Options
Paramètres de SDXL Plus
Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.
| Champ | Valeurs |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
Entrées
Médias acceptés en entrée par SDXL Plus
Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.
| Champ | Rôle |
|---|---|
| image | L'image de référence. |
Autres modèles d'image
Autres API de génération d'images sur Mage
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
Image · à partir de 20 Gems
API Anima
Conçu spécialement pour l'anime
Image · à partir de 35 Gems
API Chroma
Poids ouverts, basé sur Flux
FAQ
Questions fréquentes
Combien coûte l'API SDXL Plus ?
Une requête SDXL Plus avec les réglages par défaut (SDXL Plus) coûte 15 Gems, soit environ 0,015 $. D'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 que bloque la politique de contenu de Mage ne l'est pas.
Quel est le point de terminaison de l'API SDXL Plus ?
POST https://api.mage.space/v1/sdxl_plus/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles SDXL Plus puis-je appeler ?
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. Le modèle par défaut est SDXL Plus.
SDXL Plus prend-il en charge les images de référence ou les personnages ?
SDXL Plus accepte image. Il ne prend pas en charge les mentions @handle.
Puis-je utiliser SDXL Plus depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor, et demande SDXL Plus par son nom. Ton assistant lit ses options avec get_model et annonce le prix avant de générer.
Combien de temps les résultats de SDXL Plus 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.