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

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

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

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

seedance-2-mini

Είσοδοι

text, file

Files API

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

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

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⌉

Δυνατότητα

Βίντεο

Χρέωση

METERED

Όριο prompt

20000 χαρακτήρες

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

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

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

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

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
seedance_sceneselectΌχιtext-text, frames, referenceΗ σκηνή ορίζει ποιες μεταφορτώσεις είναι έγκυρες· οι είσοδοι κειμένου, καρέ και αναφοράς δεν μπορούν να αναμειχθούν.
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 / step 1-Επιλέξτε ακέραια διάρκεια εξόδου από 4 έως και 15 δευτερόλεπτα.
generate_audioselectΌχιtrue-true, falseΖητήστε παραγόμενο ήχο μαζί με το κλιπ εξόδου.
web_searchselectΌχιfalse-false, trueΔιατίθεται μόνο για κείμενο-σε-βίντεο· η ενεργοποίησή της με καρέ ή αναφορές απορρίπτεται.
nsfw_checkerselectΌχιtrue-false, trueΕνεργοποιήστε το προαιρετικό φίλτρο περιεχομένου του μοντέλου. Κανένα αυτοματοποιημένο φίλτρο δεν μπορεί να εγγυηθεί πλήρη κάλυψη.

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

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

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

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

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

15

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

image, video, audio

Token διάρκειας

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

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

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

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

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

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

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

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

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

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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