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

Διαθέσιμο μέσω APIText ή URL ready. Τα reference modes χρησιμοποιούν Files APIΕικόνα

ID μοντέλου API

flux-kontext-pro

Inputs

text, file

Files API

Απαιτείται για reference modes

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

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

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

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

Στείλτε το model id στο top level. Τα model-specific controls ανήκουν στο params.

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

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

Key	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
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	Όχι	-	-	-	Υδατογράφημα

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

Ανεβάστε πρώτα reference files και μετά τοποθετήστε το returned URL και το duration token μέσα στο params.referenceMediaItems.

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

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

Max files

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

image

Token διάρκειας

Τα video και audio references πρέπει να μεταφέρουν durationToken από /api/v1/files όταν απαιτείται duration verification.

kind	Max size	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"
      }
    ]
  }
}

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

Το create endpoint επιστρέφει public task id. Κάντε poll στο status endpoint μέχρι το task να succeed ή fail.

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

Ορισμένα modes απαιτούν reference uploads μέσω Files API.

Flux Kontext Pro API integration