seedance-2.5 API

Utilisez l’ID de modèle exact seedance-2.5. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortieseedance-2.5POST /v1/videos5.1s

Paramètres : duration=5resolution=1080pratio=16:9

Prompt : A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

Requête qui a produit cet échantillon

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Authentification et point de terminaison

Utilisez une clé API Modelflare avec https://modelflare.dev/v1. Le point d’entrée de la passerelle est POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Créer une tâche

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

Sondage et téléchargement

Enregistrez l’ID de la tâche. Sondez GET /v1/videos/{task_id} et téléchargez avec GET /v1/videos/{task_id}/content. Les URL des résultats peuvent expirer, alors transférez le fichier rapidement.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Demander des notes

Seedance utilise content[] pour le texte, les cadres et les médias de référence ; le contrat distinct Seedance Asset Management est documenté de manière indépendante.

Note

Téléversez d’abord les images de personnes virtuelles dans la bibliothèque de ressources Seedance. Attendez le statut Active, puis utilisez asset://<ID> dans content[]. Modelflare ne propose pas de vérification de personnes réelles.

Paramètres de requête

Seedance utilise une enveloppe multimodale asynchrone. Mettez le texte et les médias dans content[] ; les rôles multimédias sélectionnent les flux de travail de première/dernière image ou de référence.

Champ	Obligatoire	Remarques
model	Oui	seedance-2.5
content[]	Oui	text, image_url, video_url et audio_url ; utiliser role pour identifier l’objectif du média
resolution	Non	480p / 720p / 1080p
ratio	Non	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Non	-1 pour une synchronisation automatique, ou 4 à 30 secondes
generate_audio	Non	Générez des dialogues, des effets et un fond audio synchronisés
tools	Non	Utilisez web_search uniquement là où la page de modèle officielle le prend en charge
watermark	Non	S’il faut ajouter un filigrane
omni_reference_task_type	Non	auto / reference / edit / extend ; le montage et l’extension imposent des règles de rapport/durée plus strictes
output_format	Non	mp4 / mov
return_last_frame	Non	Renvoie l’image finale sous forme d’image

Limites d’entrée et de sortie

Ce modèle prend en charge 480p, 720p et 1080p. Utilisez -1 pour la synchronisation automatique ou choisissez 4 à 30 secondes. Une demande peut combiner jusqu’à 30 images, 10 vidéos et 10 clips audio. La génération de référence ordinaire accepte un rapport explicite ou adaptive ; les flux de travail d’édition, d’extension et de première/dernière image nécessitent ratio: "adaptive", et l’édition nécessite duration: -1. Les images de personnes virtuelles doivent d’abord être téléversées dans la bibliothèque de ressources ; Modelflare ne propose pas de vérification de personnes réelles.

Exemples de flux de travail documentés

Seedance 2.5 classe les flux de travail de référence, d’édition, d’extension et guidés par cadre à partir des rôles multimédias et du type de tâche. Les exemples conservent le contrat officiel tout en utilisant le point de terminaison et l’ID de modèle de Modelflare.

Référence multimodale

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

Montage vidéo

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

Extension vidéo

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

Première et dernière images

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

Erreurs et tâches ayant échoué

Les paramètres de modèle invalides renvoient un 4xx avec un ID de demande. Une tâche asynchrone peut également échouer une fois la création réussie ; utilisez error_code et error_message de la réponse au sondage comme raison finale de la tâche. Ne réessayez pas la même requête avec une forme JSON différente.

Portée prise en charge

Cette page couvre la génération et l’édition de modèles Modelflare. L’enrichissement de la recherche ou de la carte, la gestion de la voix et la gestion de la bibliothèque d’éléments sont des API de ressources en dehors de cette surface d’appel de modèle publique et ne sont pas des champs de requête obligatoires.

Tarification et facturation

Ce modèle utilise une facturation basée sur des jetons. Consultez la page de tarification du modèle pour connaître le prix client actuel, le prix catalogue de référence et les spécifications complètes.

Note

Cette page documente l’interface publique de Modelflare ; les champs et limites indiqués ici sont le contrat en cours.

Variantes

ID du modèle	Différence
seedance-2.5	Le modèle documenté sur cette page.