↓
Documentation Rivya AI
Pages API par modèle

Intégration API Seedance 2.0 Fast

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

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

Tarif en crédits: 6,8–24,8 / 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

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-fastUtilisez seedance-2-fast 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, referenceSélectionne le parcours Seedance 2 à exécuter : text-to-vidéo pur, guidage par première frame / première-dernière frame, ou génération avec référence multimodale.
resolutionselectNon720p-480p, 720pRésolution
aspect_ratioselectNon16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveFormat d'image
durationnumberNon5min 4 / max 15-Durée
generate_audioselectNontrue-true, falseGénérer l'audio
return_last_frameselectNonfalse-false, trueRetourne aussi la dernière frame sous forme d'image fixe, utile pour les couvertures, les générations suivantes ou le montage ultérieur.
web_searchselectNonfalse-false, trueRecherche web
nsfw_checkerselectNonfalse-false, trueVérification NSFW

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

Référence multimodale: Frames: 1–2 signed images. Reference: up to 9 JPEG/PNG/WebP/BMP/TIFF/GIF images under 30 MB each, 3 MP4/MOV videos of 2–15 seconds under 50 MB each, and 3 MP3/WAV audio clips of 2–15 seconds under 15 MB each. Video and audio each have a separate 15-second total limit.

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/bmp, image/gif, image/tiff
video50 MBvideo/mp4, video/quicktime
audio15 MBaudio/mpeg, audio/wav, audio/x-wav

Requête minimale

{
  "model": "seedance-2-fast",
  "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": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Requête avec fichier de référence

{
  "model": "seedance-2-fast",
  "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": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false",
    "seedance_reference_videos": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "sizeBytes": 8388608,
        "mimeType": "video/mp4"
      }
    ],
    "videoMetadata": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "token": "video_metadata_token_from_files_api",
        "sizeBytes": 8388608
      }
    ]
  }
}

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_fast_example",
  "status": "queued",
  "model": "seedance-2-fast",
  "reserved_credits": 124,
  "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.