API Z-Image

En un coup d’œil

L'API Z-Image exécute Z-Image via Mage à l'adresse POST https://api.mage.space/v1/z_image/generate. Une requête avec les réglages par défaut coûte 10 Gems (environ 0,01 $), sans abonnement. Z-Image n'accepte pas les mentions @handle.

• Image

  Sortie

• 1

  Variante

• 10

  Gems par image, par défaut

• $0.01

  Environ, en USD

Présentation

Ce que fait l'API Z-Image

Ultra rapide et économe en Gems. Texte vers image photoréaliste avec une anatomie soignée et des lettrages nets, jusqu'en 2K ; sans images de référence.

Le modèle d'images le plus rapide de Mage : texte vers image photoréaliste avec une anatomie et des lettrages soignés, en 1K ou 2K.

Il génère à partir du prompt seul.

Démarrage rapide

Appeler l'API Z-Image

Définis MAGE_API_KEY, envoie ta requête à /z_image/generate, puis interroge status_url jusqu'à la fin de la requête.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_image/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": "z-image-turbo"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('z_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'z-image-turbo',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

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

Modèles

Valeurs model_id de Z-Image

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

Options

Paramètres de Z-Image

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

Autres modèles d'image

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

FAQ

Questions fréquentes

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.

À voir aussi

• API de génération d'images IA
• Référence de l'API Z-Image
• Playground Z-Image
• Tous les modèles de l'API
• Serveur MCP Mage