Τεκμηρίωση Rivya AI
Σελίδες API μοντέλων

Ενσωμάτωση API για Seedance 2.0 Fast

Χρησιμοποιήστε το Seedance 2.0 Fast μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου seedance-2-fast, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΚείμενο ή URL έτοιμο. Οι λειτουργίες αναφοράς χρησιμοποιούν το Files APIΒίντεο
ID μοντέλου API

seedance-2-fast

Είσοδοι

text, file

Files API

Απαιτείται για λειτουργίες αναφοράς

Βασικές πιστώσεις

per_input_and_output_second · 480p_with_video=6.8 · 480p_without_video=11.7 · 720p_with_video=15 · 720p_without_video=24.8 · ⌈total⌉

Δυνατότητα

Βίντεο

Χρέωση

METERED

Όριο prompt

20000 χαρακτήρες

Σύμβαση αιτήματος

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαιseedance-2-fastΧρησιμοποιήστε το seedance-2-fast ως αναγνωριστικό μοντέλου API.
promptstringΝαι-Μέγιστο 20000 χαρακτήρες για αυτό το μοντέλο.
paramsobjectΌχι-Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_idstringΌχι-Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

Παράμετροι μοντέλου

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
seedance_sceneselectΌχιtext-text, frames, referenceΕπιλέγει ποια διαδρομή Seedance 2 θα εκτελεστεί: καθαρό κείμενο σε βίντεο, καθοδήγηση πρώτου καρέ / πρώτου-τελευταίου καρέ ή δημιουργία με πολυτροπική αναφορά.
resolutionselectΌχι720p-480p, 720pΑνάλυση
aspect_ratioselectΌχι16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveΑναλογία διαστάσεων
durationnumberΌχι5min 4 / max 15-Διάρκεια
generate_audioselectΌχιtrue-true, falseΔημιουργία ήχου
return_last_frameselectΌχιfalse-false, trueΕπιστρέφει επίσης το τελικό καρέ ως στατική εικόνα, κάτι χρήσιμο για εξώφυλλα, επόμενες εκτελέσεις ή μεταγενέστερη επεξεργασία.
web_searchselectΌχιfalse-false, trueΑναζήτηση στο web
nsfw_checkerselectΌχιfalse-false, trueΈλεγχος NSFW

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Πολυτροπική αναφορά: 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.

Μέγιστος αριθμός αρχείων

15

Αποδεκτοί τύποι αρχείων

image, video, audio

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kindΜέγιστο μέγεθοςMIME types
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

Ελάχιστο αίτημα

{
  "model": "seedance-2-fast",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "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"
  }
}

Αίτημα με αρχείο αναφοράς

{
  "model": "seedance-2-fast",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "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
      }
    ]
  }
}

Απόκριση δημιουργίας

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

{
  "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
}

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.