Documentation Rivya AI
Pages API par modèle

Intégration API Seedance 2.0 Mini

Utilisez Seedance 2.0 Mini via Rivya Public API v1 avec le model id seedance-2-mini, 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-mini

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

per_input_and_output_second · 480p_with_video=2.4 · 480p_without_video=3.8 · 720p_with_video=5 · 720p_without_video=8.2 · ⌈total⌉

Capacité

Vidéo

Facturation

METERED

Limite de prompt

20000 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éTypeObligatoirePar défautDescription
modelstringOuiseedance-2-miniUtilisez seedance-2-mini comme ID de modèle API.
promptstringOui-Maximum 20000 caractères pour ce modèle.
paramsobjectNon-Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_idstringNon-ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

CléTypeObligatoirePar défautPlageOptionsDescription
seedance_sceneselectNontext-text, frames, referenceLe scénario détermine les fichiers importés valides ; les entrées texte, images et références ne peuvent pas être mélangées.
resolutionselectNon720p-480p, 720pLe tarif varie selon la résolution et selon que le scénario référence contient ou non une vidéo.
aspect_ratioselectNon16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveFormat d’image
durationnumberNon5min 4 / max 15 / step 1-Choisissez une durée de sortie en secondes entières, de 4 à 15.
generate_audioselectNontrue-true, falseDemandez la génération d’une piste audio avec la séquence de sortie.
web_searchselectNonfalse-false, trueDisponible uniquement en mode texte-vers-vidéo ; son activation avec des images ou des références entraîne le refus de la requête.
nsfw_checkerselectNontrue-false, trueActivez 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 multimodales: Le scénario images accepte une ou deux images JPEG/PNG/WebP/GIF de 30 MB maximum chacune. Le scénario référence accepte jusqu’à 9 images de ces formats, 3 vidéos MP4/MOV/MKV de 50 MB maximum et de 2 à 15 secondes chacune, ainsi que 3 fichiers audio MP3/WAV de 15 MB maximum et de 2 à 15 secondes chacun ; les durées cumulées de la vidéo et de l’audio sont chacune plafonnées à 15 secondes.

Nombre max. de fichiers

15

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.

kindTaille max.Types MIME
image30 MBimage/jpeg, image/png, image/webp, image/gif
video50 MBvideo/mp4, video/quicktime, video/x-matroska
audio15 MBaudio/mpeg, audio/wav, audio/x-wav

Requête minimale

{
  "model": "seedance-2-mini",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

Requête avec fichier de référence

{
  "model": "seedance-2-mini",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "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_mini_example",
  "status": "queued",
  "model": "seedance-2-mini",
  "reserved_credits": 41,
  "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.