Χρησιμοποιήστε το HappyHorse 1.0 μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου happyhorse-1-0, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

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

ID μοντέλου API

happyhorse-1-0

Είσοδοι

text, file

Files API

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

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

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

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

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
resolution	select	Όχι	1080p	-	720p, 1080p	Ανάλυση
aspect_ratio	select	Όχι	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Λόγος διαστάσεων
duration	number	Όχι	5	min 3 / max 15	-	Διάρκεια
audio_setting	select	Όχι	auto	-	auto, origin	Ήχος βίντεο
seed	number	Όχι	0	min 0 / max 2147483647	-	Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.

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

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

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

Πολυμέσα αναφοράς: Χρησιμοποιήστε έως 9 εικόνες χωρίς βίντεο ή 1 βίντεο με έως 5 εικόνες αναφοράς για επεξεργασία βίντεο.

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

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

image, video

Token διάρκειας

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

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

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

{
  "model": "happyhorse-1-0",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0
  }
}

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

{
  "model": "happyhorse-1-0",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_happyhorse_1_0_example",
  "status": "queued",
  "model": "happyhorse-1-0",
  "reserved_credits": 28,
  "final_credits": 0,
  "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 για HappyHorse 1.0