Passer au contenu

API Mage · Modèle d'image

API HiDream

Rapide et polyvalent, avec prompts négatifs

POST https://api.mage.space/v1/hidream/generate

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.

  • ImageSortie
  • 1Variante
  • 20Gems par image, par défaut
  • $0.02Environ, 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.

cURL
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"
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('hidream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'hidream-fast',
});

console.log(request.result.url);
Python
# 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.

model_idNomPar défaut
hidream-fastHiDreamOui

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.

ChampValeurs
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Autres modèles d'image

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

  • Image · à partir de 20 Gems

    Krea 2 API

    Une esthétique superbe en quelques secondes

  • Image · à partir de 42 Gems

    API Mango

    Notre famille d'images phare

  • Image · à partir de 15 Gems

    API MiniMax H3 Image

    Images natives de 16 mégapixels, poids ouverts

  • Image · à partir de 25 Gems

    API MOSS-Image

    Prompts longs et texte bilingue, poids ouverts

  • Image · à partir de 51 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

FAQ

Questions fréquentes

Combien coûte l'API HiDream ?
Une requête HiDream avec les réglages par défaut (HiDream) coûte 20 Gems, soit environ 0,02 $. 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 ; celle bloquée par la politique de contenu de Mage ne l'est pas.
Quel est le endpoint de l'API HiDream ?
POST https://api.mage.space/v1/hidream/generate avec un en-tête Authorization: Bearer contenant ta clé d'API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles HiDream puis-je appeler ?
hidream-fast. Le modèle par défaut est HiDream.
HiDream prend-il en charge les images de référence ou les personnages ?
HiDream n'accepte aucune image, vidéo ou entrée audio. HiDream ne prend pas en charge les mentions @handle.
Puis-je utiliser HiDream depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande HiDream par son nom. Ton assistant lit ses options avec get_model et indique le prix avant de générer.
Combien de temps les résultats HiDream 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.

CharactersCommunauté