API Mage · Modèle d'image

API Stable Diffusion XL

Un SDXL optimisé pour le photoréalisme

Obtenir une clé d'APIEssayer Stable Diffusion XL dans le playground
POST https://api.mage.space/v1/stable_diffusion_xl/generate

En un coup d’œil

L'API Stable Diffusion XL exécute Stable Diffusion XL via Mage à l'adresse POST https://api.mage.space/v1/stable_diffusion_xl/generate. Une requête avec les réglages par défaut coûte 10 Gems (environ 0,01 $), sans abonnement. Stable Diffusion XL ne prend pas en charge les mentions @handle.

Présentation

Ce que fait l'API Stable Diffusion XL

Le classique Stable Diffusion XL, optimisé pour un rendu photoréaliste. Du texte vers l'image, ou à partir d'une image en entrée, à petit prix.

Stable Diffusion XL, optimisé pour un rendu photoréaliste, avec une image en entrée facultative.

Il accepte image en entrée.

Démarrage rapide

Appeler l'API Stable Diffusion XL

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

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

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

Modèles

Valeurs de model_id pour Stable Diffusion XL

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

model_idNomPar défaut
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XLOui

Options

Paramètres de Stable Diffusion XL

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

Entrées

Médias acceptés en entrée par Stable Diffusion XL

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.

Autres modèles d'image

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

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

Image · à partir de 40 Gems

API Flux 2

Prompts longs et retouches multi-références

Image · à partir de 9 Gems

API GPT Image 2

Prompts précis et texte lisible

Image · à partir de 75 Gems

API Grok Image

Grok Imagine, en trois niveaux de qualité

FAQ

Questions fréquentes

Combien coûte l'API Stable Diffusion XL ?

Une requête Stable Diffusion XL avec les réglages par défaut (Stable Diffusion XL) coûte 10 Gems, soit environ 0,01 $. 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, mais pas celle que bloque la politique de contenu de Mage.

Quel est le point de terminaison de l'API Stable Diffusion XL ?

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

Quels modèles Stable Diffusion XL puis-je appeler ?

6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. Le modèle par défaut est Stable Diffusion XL.

Stable Diffusion XL prend-il en charge les images de référence ou les personnages ?

Stable Diffusion XL accepte image. Stable Diffusion XL n'accepte pas les mentions @handle.

Puis-je utiliser Stable Diffusion XL depuis Claude ou ChatGPT ?

Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor, puis demande Stable Diffusion XL 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 Stable Diffusion XL 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 Stable Diffusion XL dans le playground

À voir aussi