Utilisez Seedance 2.5 via Rivya Public API v1 avec le model id seedance-2-5, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APITexte ou URL prêt ; les modes de référence utilisent Files APIVidéo

ID de modèle API

seedance-2-5

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

Tarif en crédits: 17–158 / seconde de durée vidéo totale (entrée + sortie) Le coût final de la tâche est arrondi au crédit entier supérieur.

Capacité

Vidéo

Facturation

METERED

Limite de prompt

20480 caractères

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	seedance-2-5	Utilisez seedance-2-5 comme ID de modèle API.
prompt	string	Non	-	Maximum 20480 caractères pour ce modèle.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
seedance_scene	select	Non	text	-	text, frames, reference	Choisissez le contrat d’entrée avant l’importation ; le texte, le guidage par images et les références sont des scénarios mutuellement exclusifs.
resolution	select	Non	720p	-	480p, 720p, 1080p	Chaque résolution possède des tarifs distincts selon la présence ou non d’une vidéo.
aspect_ratio	select	Non	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Format d’image
duration	number	Non	5	min -1 / max 30 / step 1	-	Choisissez -1 pour la durée automatique ou un nombre entier de 4 à 30 secondes. La durée automatique réserve 30 secondes de sortie avant l’exécution.
output_format	select	Non	mp4	-	mp4, mov	Format de sortie
generate_audio	select	Non	true	-	true, false	Demandez la génération d’une piste audio avec la séquence de sortie.
return_last_frame	select	Non	false	-	false, true	Renvoyez aussi la dernière image de la vidéo sous forme d’image fixe pour la révision ou la suite du travail.
web_search	select	Non	false	-	false, true	Autorisez le modèle à utiliser sa fonction facultative de recherche web pour cette génération.
nsfw_checker	select	Non	true	-	false, true	Activez le filtre de contenu facultatif du modèle. Aucun filtre automatisé ne peut garantir une couverture complète.

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Images guides ou références de grande capacité: Le scénario images accepte 1 ou 2 images JPEG/PNG/WebP de 30 MB maximum chacune. Le scénario référence accepte jusqu’à 30 images, 10 vidéos MP4/MOV de 95 MB maximum et de 2 à 30 secondes chacune, ainsi que 10 fichiers audio MP3/WAV de 15 MB maximum et de 2 à 30 secondes chacun ; les durées cumulées de la vidéo et de l’audio sont chacune plafonnées à 30 secondes, et l’ensemble des médias à 50 fichiers.

Nombre max. de fichiers

Types de fichier acceptés

image, video, audio

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
image	30 MB	image/jpeg, image/png, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Requête minimale

{
  "model": "seedance-2-5",
  "prompt": "Une caméra tourne lentement autour d’un flacon de produit posé sur une table de studio.",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

Requête avec fichier de référence

{
  "model": "seedance-2-5",
  "prompt": "Une caméra tourne lentement autour d’un flacon de produit posé sur une table de studio.",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

{
  "id": "task_seedance_2_5_example",
  "status": "queued",
  "model": "seedance-2-5",
  "reserved_credits": 315,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API Seedance 2.5