Ενσωμάτωση API για Flux 2 Flex
Χρησιμοποιήστε το Flux 2 Flex μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου flux-2-flex, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.
flux-2-flex
text, file
Απαιτείται για λειτουργίες αναφοράς
14
Εικόνα
FIXED
5000 χαρακτήρες
Σύμβαση αιτήματος
Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Περιγραφή |
|---|---|---|---|---|
| model | string | Ναι | flux-2-flex | Χρησιμοποιήστε το flux-2-flex ως αναγνωριστικό μοντέλου API. |
| prompt | string | Ναι | - | Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο. |
| params | object | Όχι | - | Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά. |
| client_request_id | string | Όχι | - | Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα. |
Παράμετροι μοντέλου
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Εύρος | Επιλογές | Περιγραφή |
|---|---|---|---|---|---|---|
| aspectRatio | select | Όχι | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 | Αναλογία κάδρου |
| resolution | select | Όχι | 1K | - | 1K, 2K | Ανάλυση |
Πολιτική μεταφόρτωσης
Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.
Εικόνα αναφοράς: Ανεβάστε έως 8 αρχεία εικόνας για έργα επεξεργασίας εικόνας.
8
image
Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.
| kind | Μέγιστο μέγεθος | MIME types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Ελάχιστο αίτημα
{
"model": "flux-2-flex",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspectRatio": "1:1",
"resolution": "1K"
}
}Αίτημα με αρχείο αναφοράς
{
"model": "flux-2-flex",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspectRatio": "1:1",
"resolution": "1K",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Απόκριση δημιουργίας
Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.
{
"id": "task_flux_2_flex_example",
"status": "queued",
"model": "flux-2-flex",
"reserved_credits": 14,
"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.