Χρησιμοποιήστε το Flux Kontext Pro μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου flux-kontext-pro, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

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

ID μοντέλου API

flux-kontext-pro

Είσοδοι

text, file

Files API

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

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

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

Δεν υπάρχει τεκμηριωμένο όριο prompt

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

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

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

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
aspectRatio	select	Όχι	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Αναλογία κάδρου
outputFormat	select	Όχι	jpeg	-	jpeg, png	Το JPEG είναι μικρότερο, ενώ το PNG είναι καλύτερο για διαφάνεια ή πιο καθαρές ακμές χωρίς απώλειες.
enableTranslation	select	Όχι	true	-	true, false	Αυτόματη μετάφραση προτροπής
promptUpsampling	select	Όχι	false	-	false, true	Όταν είναι ενεργό, η Rivya αφήνει το μοντέλο να επεκτείνει και να γυαλίσει την προτροπή σας πριν από τη δημιουργία. Συχνά βοηθά στην ποιότητα λεπτομέρειας, αλλά μπορεί επίσης να κάνει το αποτέλεσμα πιο ερμηνευτικό από την ακατέργαστη προτροπή σας.
safetyTolerance	number	Όχι	2	min 0 / max 6	-	Ελέγχει πόσο αυστηρή είναι η εποπτεία περιεχομένου. Η δημιουργία συνήθως επιτρέπει ευρύτερο φάσμα από την επεξεργασία· οι χαμηλότερες τιμές είναι πιο αυστηρές και οι υψηλότερες πιο επιτρεπτικές.
watermark	text	Όχι	-	-	-	Υδατογράφημα

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

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

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

Εικόνα αναφοράς: Ανεβάστε έως 1 αρχείο εικόνας για έργα επεξεργασίας εικόνας.

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

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

image

Token διάρκειας

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

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

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

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Προαιρετικό κείμενο υδατογραφήματος"
  }
}

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

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Προαιρετικό κείμενο υδατογραφήματος",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_flux_kontext_pro_example",
  "status": "queued",
  "model": "flux-kontext-pro",
  "reserved_credits": 4,
  "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 για Flux Kontext Pro