API HiDream

En un coup d’œil

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

• Image

  Sortie

• 1

  Variante

• 20

  Gems par image, par défaut

• $0.02

  Environ, en USD

Présentation

Ce que fait l'API HiDream

Un modèle généraliste rapide de texte vers image, avec prompt négatif. Parfait pour les prompts du quotidien, photoréalistes ou illustrés.

Un modèle d'image généraliste rapide, avec prompt négatif, photoréaliste ou illustré.

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

Démarrage rapide

Appeler l'API HiDream

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

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

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

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

Modèles

Valeurs model_id de HiDream

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

Options

Paramètres de HiDream

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 HiDream
• Playground HiDream
• Tous les modèles de l'API
• Serveur MCP Mage