Passer au contenu

API Mage · Modèle vidéo

API Seedance

Seedance, avec un filtre strict

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

En un coup d’œil

L'API Seedance fait tourner Seedance 2.5 et 3 autres variantes via Mage sur POST https://api.mage.space/v1/seedance/generate. Une requête avec les réglages par défaut coûte 618 Gems (environ 0,618 $), sans abonnement. Seedance accepte les personnages enregistrés, les références et les références audio via @handle dans le prompt.

  • VidéoSortie
  • 4Variantes
  • 618Gems par clip, par défaut
  • $0.618Environ, en USD

Présentation

Ce que fait l'API Seedance

Seedance de ByteDance, de Seedance 2.0 Mini pour les brouillons à Seedance 2.5, avec des clips jusqu'à 30 secondes, de nombreuses références ou Characters, et des modifications de vidéo source. Filtre strict : le filtre de contenu du fournisseur s'applique.

La gamme vidéo Seedance de ByteDance, avec mouvements cinématographiques et audio : Seedance 2.0 Mini, Seedance 2.0 Fast, Seedance 2.0 et Seedance 2.5, le plus puissant, avec des clips allant jusqu'à 30 secondes. Filtre strict : le filtre de contenu du fournisseur analyse le prompt, les médias en entrée et la vidéo finale ; une requête qu'il refuse échoue avec `content_blocked` et un motif, et elle est remboursée.

Elle accepte image, additional_images et videos en entrée.

Démarrage rapide

Appeler l'API Seedance

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedance/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "4",
  "model_id": "seedance-2.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('seedance', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'seedance-2.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("seedance", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "seedance-2.5",
})

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

Modèles

Valeurs model_id de Seedance

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

model_idNomPar défaut
seedance-2.0-miniSeedance 2.0 Mini
seedance-2.0-fastSeedance 2.0 Fast
seedance-2.0Seedance 2.0
seedance-2.5Seedance 2.5Oui

Options

Paramètres de Seedance

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_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

Entrées

Médias acceptés par Seedance

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.
videosLes vidéos sources.

Règles

Ce que l'API Seedance impose

  • L'édition vidéo prend exactement une vidéo source, de 4 à 30 secondes sur `seedance-2.5` et de 2 à 15 secondes sur les autres modèles.
  • Sur `seedance-2.5`, une modification conserve la durée et le format d'image de sa vidéo source : `duration` et `aspect_ratio` sont ignorés, et le prix suit la durée de la vidéo.

Plus de modèles vidéo

Autres API de génération vidéo sur Mage

  • Vidéo · à partir de 245 Gems

    API Wan 3.0

    Wan 3.0, avec un filtre strict

  • Vidéo · à partir de 40 Gems

    API Wan Video v2.2

    Vidéo open-weights avec une variante Lightning

  • Vidéo · à partir de 189 Gems

    API Berry

    Une vidéo fidèle à tes références

  • Vidéo · à partir de 360 Gems

    API Blueberry

    Fixe la première et la dernière frame

  • Vidéo · à partir de 618 Gems

    API Cherry

    Notre famille de vidéos phare

  • Vidéo · à partir de 375 Gems

    API Grok Video

    Grok Imagine, en mouvement

FAQ

Questions fréquentes

Combien coûte l'API Seedance ?
Une requête Seedance avec les réglages par défaut (Seedance 2.5) coûte 618 Gems, soit environ 0,618 $. D'autres résolutions, durées et variantes changent 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 l'endpoint de l'API Seedance ?
POST https://api.mage.space/v1/seedance/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 Seedance puis-je appeler ?
seedance-2.0-mini (Seedance 2.0 Mini), seedance-2.0-fast (Seedance 2.0 Fast), seedance-2.0 (Seedance 2.0), seedance-2.5 (Seedance 2.5). Le modèle par défaut est Seedance 2.5.
Seedance accepte-t-il les images de référence ou les personnages ?
Seedance accepte image, additional_images, videos. Seedance accepte les personnages enregistrés, les références et les références audio via @handle dans le prompt.
Puis-je utiliser Seedance depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Seedance par son nom. Ton assistant lit ses options avec get_model et annonce le prix avant de générer.
Combien de temps les résultats Seedance 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.