Black Forest Labs: FLUX.2 Klein 4B
Το FLUX.2 [klein] 4B είναι το συμπαγές μοντέλο εικόνας της Black Forest Labs με απόσταξη βημάτων, για δημιουργία από κείμενο και επεξεργασία με έως τέσσερις αναφορές. Η σχεδίαση τεσσάρων βημάτων υποστηρίζει διαδραστική οπτική εργασία, διατηρώντας χωριστή ταυτότητα από την έκδοση Base 4B χωρίς απόσταξη.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το FLUX.2 [klein] 4B είναι το συμπαγές μοντέλο της Black Forest Labs για δημιουργία εικόνας από περιγραφή κειμένου και επεξεργασία εικόνων με οπτικές αναφορές. Ο transformer rectified-flow τεσσάρων δισεκατομμυρίων παραμέτρων συνδυάζει δημιουργία και επεξεργασία σε μία αρχιτεκτονική. Η ονομασμένη έκδοση 4B έχει υποστεί απόσταξη βημάτων και το παράδειγμα αναφοράς του κατασκευαστή χρησιμοποιεί τέσσερα βήματα συμπερασμού.
Ο ρόλος του μοντέλου είναι ένα διαδραστικό οπτικό προσχέδιο ή αναθεώρηση: διερεύνηση σκηνής προϊόντος, αλλαγή ενδυμασίας χαρακτήρα, συνδυασμός θέματος με περιβάλλον ή βελτίωση εμφάνισης εικονογράφησης. Ξεκινήστε από το γεγονός ή τη σύνθεση που έχει σημασία και περιγράψτε κατόπιν το θέμα, το υλικό, τον φωτισμό και την οπτική γωνία. Μια συγκεκριμένη περιγραφή θα μπορούσε να τοποθετεί ματ μπλε κεραμικό φλιτζάνι σε ανοιχτόχρωμο δρύινο τραπέζι, σε κοντινή λήψη με πλευρικό φωτισμό που διατηρεί ορατά το χερούλι και το σμάλτο. Το αποτέλεσμα είναι εικόνα για έλεγχο σε σχέση με αυτές τις αποφάσεις.
Επεξεργασία με μικρό σύνολο αναφορών
Το τεκμηριωμένο προφίλ 4B δέχεται έως τέσσερις εικόνες εισόδου. Δώστε σαφή ρόλο σε καθεμία: εμφάνιση προϊόντος, χαρακτήρας, περιβάλλον ή ύφος. Αν μία εικόνα είναι η σκηνή προς επεξεργασία, προσδιορίστε την και δηλώστε τόσο την αλλαγή όσο και τις λεπτομέρειες που θα διατηρηθούν. Για παράδειγμα, κρατήστε τη σιλουέτα και την επιφάνεια του φλιτζανιού από την πρώτη εικόνα, χρησιμοποιήστε το δωμάτιο της δεύτερης και αντικαταστήστε μόνο το κάλυμμα του τραπεζιού. Η σειρά αναφορών και μια ακριβής οδηγία αλλαγής δίνουν σαφέστερο στόχο στην αναθεώρηση από ένα αίτημα γενικής βελτίωσης.
Ο κατασκευαστής διακρίνει αυτό το μικρό όριο αναφορών από τις μεγαλύτερες παραλλαγές FLUX.2. Αναφέρει επίσης ότι το [klein] δεν διαθέτει εμπλουτισμό προτροπής. Δώστε εσείς τις σημαντικές περιγραφικές πληροφορίες, μαζί με τη σχέση μεταξύ αντικειμένων αναφοράς, αντί να βασίζεστε σε αυτόματη επέκταση σύντομης ετικέτας. Για σειρά εικόνων, κρατήστε την ίδια αναφορά θέματος και τις οπτικές απαιτήσεις, αλλάζοντας κάθε φορά μία απόφαση σκηνής.
Ρυθμίσεις εξόδου και όρια εκδόσεων
Το συγκεκριμένο προφίλ 4B του παραγωγού αναφέρει έξοδο JPEG, PNG και WebP, με προεπιλογή JPEG. Τεκμηριώνονται ρητές τιμές πλάτους και ύψους με ελάχιστο 64 pixel για καθεμία· το παράδειγμα της κάρτας μοντέλου αναφοράς χρησιμοποιεί εικόνα 1024×1024. Αυτό το παράδειγμα είναι ρύθμιση δειγματοληψίας, όχι ισχυρισμός ότι κάθε εργασία πρέπει να είναι τετράγωνη ή ότι τα 1024 pixel είναι το μέγιστο του μοντέλου. Επιλέξτε την επιθυμητή περικοπή και το σχήμα προβολής πριν προετοιμάσετε την οπτική περιγραφή και συγκρίνετε κατόπιν μικρά γράμματα και χαρακτηριστικά σε αυτό το μέγεθος.
Το δημοσιευμένο παράδειγμα τεσσάρων βημάτων χρησιμοποιεί guidance_scale 1.0. Διατηρήστε αυτή την αποσταγμένη έκδοση χωριστή από το FLUX.2 [klein] Base 4B, του οποίου το σήμα εκπαίδευσης χωρίς απόσταξη προορίζεται για προσαρμογή, εκπαίδευση LoRA και έρευνα. Το Base 4B και τα μοντέλα 9B είναι διαφορετικές επιλογές, με διαφορετικά ζητήματα προετοιμασίας και δειγματοληψίας. Οι τυπικοί έλεγχοι του συμπαγούς μοντέλου διαφέρουν επίσης από τα ρυθμιζόμενα βήματα και guidance του [flex]· το [max] έχει δική του δυνατότητα τεκμηρίωσης μέσω αναζήτησης.
Λεπτομέρειες που πρέπει να επαληθευτούν στην εικόνα
Η συγκεκριμένη κάρτα μοντέλου αναφέρει ότι αυτό το μοντέλο δεν είναι πηγή πραγματολογικών πληροφοριών. Το γραπτό κείμενο μέσα σε εικόνα μπορεί να είναι ανακριβές ή παραμορφωμένο και η παραγόμενη σκηνή μπορεί να αποκλίνει από το αίτημα. Το ύφος προτροπής επηρεάζει σημαντικά τη συμμόρφωση. Ελέγξτε ορθογραφία, ποσότητες, ετικέτες, ταυτότητα θέματος και τα συγκεκριμένα αντικείμενα που πρέπει να παραμείνουν· μια ελκυστική σύνθεση δεν αποδεικνύει ότι ένα χαρακτηριστικό προϊόντος ή εικονογραφημένο γεγονός είναι σωστό. Ο κατασκευαστής σημειώνει επίσης ότι οι στατιστικές έξοδοι μπορούν να αντανακλούν προκαταλήψεις των δεδομένων εκπαίδευσης.
Για ελεγμένο οπτικό αρχείο, κρατήστε τις αρχικές αναφορές, την τελική διατύπωση και την επιλεγμένη ταυτότητα μοντέλου μαζί με την εικόνα. Η τεκμηρίωση έκδοσης διακρίνει το ενδεικτικό υδατογράφημα σε επίπεδο pixel στον κώδικα αναφοράς από τα μεταδεδομένα προέλευσης C2PA που εφαρμόζονται στη φιλοξενούμενη ροή εξόδου του κατασκευαστή. Η διατήρηση της επιστρεφόμενης προέλευσης βοηθά να εξηγηθεί η καταγωγή ενός οπτικού αρχείου· διαφέρει από τον έλεγχο επιτυχίας της ζητούμενης οπτικής αλλαγής.
Ailoot Ultra · Εικόνες POST /v1/images/generations black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4bΕισαγωγή
Το FLUX.2 [klein] 4B είναι το συμπαγές μοντέλο εικόνας της Black Forest Labs με απόσταξη βημάτων, για δημιουργία από κείμενο και επεξεργασία με έως τέσσερις αναφορές. Η σχεδίαση τεσσάρων βημάτων υποστηρίζει διαδραστική οπτική εργασία, διατηρώντας χωριστή ταυτότητα από την έκδοση Base 4B χωρίς απόσταξη.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Εικόνες POST /v1/images/generations
- Είσοδος
text,image- Έξοδος
image
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια black-forest-labs/flux.2-klein-4b | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Προεπιλογή— |
Πεδίοoutput_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια png, jpeg | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 1 | Προεπιλογή— |
Πεδίοinput_references | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 0 Μέγιστο πλήθος στοιχείων: 4 | Προεπιλογή— |
Πεδίοprovider | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςmaterial_types | Σύμβασηtext, image |
Κύκλος ζωής: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Το πραγματικό task_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Μονάδα τιμολόγησης | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| Διαμόρφωσηmegapixel εικόνας εξόδου | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά μεγαπίξελ εικόνας εξόδου | Χρέωση Έξοδος · megapixel εικόνας εξόδου · Εκτίμηση μόνο για σύγκριση $0.028 ανά μεγαπίξελ εικόνας εξόδου |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.028 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Εικόνες
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-klein-4b', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Εικόνες
Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Άλλες ανακτήσεις περιεχομένου
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, κάθε πραγματικό αποτέλεσμα εξόδου, τα αρχικά αναγνωριστικά που επιστράφηκαν και όλα τα πεδία χρήσης. Ανακτήστε την αρχική λειτουργία χωρίς να υποβάλετε ξανά αίτημα δημιουργίας.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το X-Client-Request-ID που επιστράφηκε για τη συμφωνία των εγγραφών. Διαβάστε μόνο πραγματικές τιμές task_id/asset_id που επιστράφηκαν ή τη βιβλιοθήκη πολυμέσων που σας ανήκει· μην κατασκευάσετε ποτέ URL εργασίας από το ID της λειτουργίας και μην υποβάλετε ποτέ ξανά αίτημα δημιουργίας.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοcreated | Τύπος |
Πεδίοdata[].url | Τύπος |
Πεδίοdata[].b64_json | Τύπος |
Πεδίοusage | Τύπος |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra black-forest-labs/flux.2-klein-4b
Εναλλακτικές διαδρομές μεθόδων
/v1/images
Σχετικά ID μοντέλων
FAQ · Black Forest Labs: FLUX.2 Klein 4B
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:text,image→image- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:model,prompt,aspect_ratio,output_format,n,input_references,provider- Ποια όρια ισχύουν;
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:n.minimum:1;n.maximum:1