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

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

ID μοντέλου API

seedance-2-5

Είσοδοι

text, file

Files API

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

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

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

Δυνατότητα

Βίντεο

Χρέωση

METERED

Όριο prompt

30000 χαρακτήρες

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

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	seedance-2-5	Χρησιμοποιήστε το seedance-2-5 ως αναγνωριστικό μοντέλου API.
prompt	string	Όχι	-	Μέγιστο 30000 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
seedance_scene	select	Όχι	text	-	text, frames, reference	Επιλέξτε το συμβόλαιο εισόδου πριν από τη μεταφόρτωση· το κείμενο, η καθοδήγηση καρέ και οι αναφορές είναι αμοιβαία αποκλειόμενες σκηνές.
resolution	select	Όχι	720p	-	480p, 720p, 1080p	Κάθε ανάλυση έχει ξεχωριστούς συντελεστές χωρίς και με βίντεο.
aspect_ratio	select	Όχι	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Αναλογία διαστάσεων
duration	number	Όχι	5	min -1 / max 30 / step 1	-	Επιλέξτε -1 για αυτόματη διάρκεια ή ακέραιο αριθμό από 4 έως και 30 δευτερόλεπτα. Η αυτόματη διάρκεια δεσμεύει 30 δευτερόλεπτα εξόδου πριν από την εκτέλεση.
output_format	select	Όχι	mp4	-	mp4, mov	Μορφή εξόδου
generate_audio	select	Όχι	true	-	true, false	Ζητήστε παραγόμενο ήχο μαζί με το κλιπ εξόδου.
return_last_frame	select	Όχι	false	-	false, true	Επιστρέψτε επίσης το τελικό καρέ του βίντεο ως στατική εικόνα για έλεγχο ή επόμενη εργασία.
web_search	select	Όχι	false	-	false, true	Επιτρέψτε στο μοντέλο να χρησιμοποιήσει τον προαιρετικό έλεγχο αναζήτησης ιστού σε αυτή την εκτέλεση.
nsfw_checker	select	Όχι	true	-	false, true	Ενεργοποιήστε το προαιρετικό φίλτρο περιεχομένου του μοντέλου. Κανένα αυτοματοποιημένο φίλτρο δεν μπορεί να εγγυηθεί πλήρη κάλυψη.

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

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

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

Καρέ καθοδήγησης ή αναφορές μεγάλης χωρητικότητας: Η σκηνή καρέ δέχεται 1 ή 2 εικόνες JPEG, PNG, WebP, BMP, GIF ή TIFF έως 30 MB η καθεμία. Η σκηνή αναφοράς δέχεται έως 30 εικόνες, 10 βίντεο MP4/MOV έως 95 MB και 2-30 δευτερόλεπτα το καθένα και 10 αρχεία ήχου MP3/WAV έως 15 MB και 2-30 δευτερόλεπτα το καθένα· το συνολικό βίντεο και ο συνολικός ήχος περιορίζονται χωριστά σε 30 δευτερόλεπτα και όλα τα πολυμέσα μαζί σε 50 αρχεία.

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

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

image, video, audio

Token διάρκειας

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

kind	Μέγιστο μέγεθος	MIME types
image	30 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

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

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

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

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

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

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

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

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

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