Passer au contenu
PlaygroundDocumentationObtenir une clé API

API Mage · Modèle d'image

API Seedream

Seedream, avec un filtre strict

Obtenir une clé d'APIEssaie Seedream dans le playground
POST https://api.mage.space/v1/seedream/generate

En un coup d’œil

L'API Seedream fait tourner Seedream 5.5 et 5 autres variantes via Mage sur POST https://api.mage.space/v1/seedream/generate. Une requête avec les paramètres par défaut coûte 42 Gems (environ 0,042 $), sans abonnement. Seedream accepte les personnages enregistrés et les références par @handle dans le prompt.

  • ImageSortie
  • 6Variantes
  • 42Gems par image, par défaut
  • $0.042Environ, en USD

Présentation

Ce que fait l'API Seedream

Seedream de ByteDance, de Seedream 5.0 Flash pour les brouillons à Seedream 5.5, le plus récent et celui par défaut, avec des scènes détaillées, du texte lisible et des retouches à partir de 10 références ou Characters maximum, jusqu'à 4K avec Seedream 4.5. Filtre strict : les prompts et les premières images sont vérifiés avant chaque exécution.

La famille d'images Seedream de ByteDance, pour des scènes détaillées, du texte lisible et des retouches à partir de jusqu'à 10 références ou Characters : Seedream 5.5 (`seedream-5.5`), le plus récent et celui par défaut, avec des images plus réalistes, un petit texte plus net et des retouches répétées plus stables ; Seedream 5.0 Pro (`seedream-5.0-pro`), l'ancien modèle phare ; Seedream 5.0 Flash (`seedream-5.0-flash`), un prix unique avec les images d'entrée incluses, le plus bas en 2K ou avec des images d'entrée (Seedream 5.5 coûte moins cher pour un prompt seul en 1K) ; Seedream 5.0 Lite (`seedream-5.0-lite`), jusqu'à 3K ; Seedream 4.5 (`seedream-4.5`), jusqu'à 4K ; et Seedream 4.0 (`seedream-4.0`). Filtre strict : Mage vérifie le prompt et la première image avant l'exécution ; une requête refusée échoue avec `content_blocked` et un motif, et elle est remboursée.

Il accepte image et additional_images en entrée.

Démarrage rapide

Appeler l'API Seedream

Définis MAGE_API_KEY, envoie ta requête à /seedream/generate et interroge status_url jusqu'à ce que la requête soit terminée.

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

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

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

Modèles

Valeurs model_id de Seedream

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

model_idNomPar défaut
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Oui

Options

Paramètres de Seedream

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
resolution1K, 2K, 3K, 4K

Entrées

Médias acceptés par Seedream

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.
additional_imagesImages de référence supplémentaires.

Autres modèles d'image

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

FAQ

Questions fréquentes

Combien coûte l'API Seedream ?
Une requête Seedream avec les paramètres par défaut (Seedream 5.5) coûte 42 Gems, soit environ 0,042 $. 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 que bloque la politique de contenu de Mage ne l'est pas.
Quel est le endpoint de l'API Seedream ?
POST https://api.mage.space/v1/seedream/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 Seedream puis-je appeler ?
seedream-4.0 (Seedream 4.0), seedream-4.5 (Seedream 4.5), seedream-5.0-lite (Seedream 5.0 Lite), seedream-5.0-pro (Seedream 5.0 Pro), seedream-5.0-flash (Seedream 5.0 Flash), seedream-5.5 (Seedream 5.5). Le modèle par défaut est Seedream 5.5.
Seedream prend-il en charge les images de référence ou les personnages ?
Seedream accepte image, additional_images. Seedream accepte les personnages enregistrés et les références via @handle dans le prompt.
Puis-je utiliser Seedream depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Seedream 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 Seedream 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'APIEssaie Seedream dans le playground