Χρησιμοποιήστε το Runway Aleph μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου runway-aleph, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΕτοιμότηταΒίντεο

ID μοντέλου API

runway-aleph

Είσοδοι

file

Files API

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

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

per_video · default=90 · ⌈total⌉

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

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

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
aspectRatio	select	Όχι	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9	Αναλογία διαστάσεων
waterMark	text	Όχι	-	-	-	Υδατογράφημα
seed	number	Όχι	-	-	-	Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.

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

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

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

Υλικό εισόδου: Ανεβάστε το κλιπ πηγής που θέλετε να μετασχηματίσει το Aleph. Προσθέστε μία προαιρετική στατική εικόνα μόνο όταν χρειάζεστε επιπλέον καθοδήγηση ύφους ή θέματος.

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

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

video, image

Token διάρκειας

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

kind	Μέγιστο μέγεθος	MIME types
video	95 MB	video/mp4, video/quicktime
image	10 MB	image/jpeg, image/png, image/webp

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

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Αφήστε το κενό για απενεργοποίηση υδατογραφήματος",
    "seed": 1
  }
}

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

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Αφήστε το κενό για απενεργοποίηση υδατογραφήματος",
    "seed": 1,
    "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"
      }
    ]
  }
}

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

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

{
  "id": "task_runway_aleph_example",
  "status": "queued",
  "model": "runway-aleph",
  "reserved_credits": 90,
  "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 για Runway Aleph