Black Forest Labs: FLUX.2 Max
Το FLUX.2 [max] είναι το μοντέλο εικόνας της Black Forest Labs για απαιτητικά τελικά οπτικά αρχεία και συνεπείς επεξεργασίες. Οι τεκμηριωμένες προδιαγραφές του συνδυάζουν οπτικές αναφορές, λεπτομερή έλεγχο σκηνής και τεκμηρίωση από τον ιστό για επίκαιρα θέματα, με έξοδο έως 4 megapixel.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το FLUX.2 [max] είναι το μέλος κορυφαίας ποιότητας της οικογένειας δημιουργίας και επεξεργασίας εικόνων FLUX.2 της Black Forest Labs. Ο κατασκευαστής το τοποθετεί για απαιτητικά τελικά οπτικά αρχεία, ισχυρή συμμόρφωση με σύνθετη περιγραφή και συνέπεια μεταξύ επεξεργασιών. Δημιουργεί εικόνα από γραπτή περιγραφή ή χρησιμοποιεί παρεχόμενες εικόνες ως οπτικές αναφορές. Η ιδιαίτερη δυνατότητά του στην οικογένεια είναι η αναζήτηση για τεκμηρίωση: ένα αίτημα μπορεί να αξιοποιεί τρέχουσες πληροφορίες, αντί να βασίζεται μόνο στη σκηνή της προτροπής.
Πληροφορίες πραγματικού κόσμου και οπτική περιγραφή
Ο κατασκευαστής τεκμηριώνει αναζήτηση ιστού για θέματα όπως ο τρέχων καιρός, πρόσφατο αθλητικό γεγονός ή ιστορικό περιβάλλον. Προσδιορίστε την πραγματική τοποθεσία, το γεγονός και τον χρόνο που αφορούν την εικόνα και περιγράψτε χωριστά την καλλιτεχνική απόδοση. Μια ιδέα τεκμηριωμένης κάρτας καιρού θα μπορούσε να καθορίζει την πόλη, τη συνθήκη που θα οπτικοποιηθεί, τον ακριβή τίτλο και τη διάταξη. Η αναζήτηση ενημερώνει τη δημιουργία· μια ελκυστική εικονογράφηση εξακολουθεί να χρειάζεται έλεγχο των ορατών γεγονότων της έναντι της σχετικής πηγής πριν γίνει πραγματολογική επικοινωνία.
Αυτή η δυνατότητα αναζήτησης ανήκει στο [max] στη δημοσιευμένη σύγκριση FLUX.2. Τα άλλα ονομασμένα μέλη έχουν δικούς τους ρόλους: [pro] για παραγωγή, [flex] για ρυθμιζόμενη δειγματοληψία και τυπογραφία και [klein] για συμπαγή διαδραστική δημιουργία. Κρατήστε το επιλεγμένο όνομα μοντέλου με το αποτέλεσμα, ώστε μεταγενέστερη αναθεώρηση να μην αντικαταστήσει σιωπηρά το προφίλ με δυνατότητα τεκμηρίωσης με άλλη έκδοση.
Αναφορές για απαιτητικές επεξεργασίες
Το τεκμηριωμένο προφίλ αιτήματος δέχεται έως οκτώ εικόνες αναφοράς· η διαδραστική διεπαφή του κατασκευαστή επιτρέπει χωριστά δέκα. Αναθέστε ρόλο σε κάθε αναφορά, όπως εμφάνιση χαρακτήρα, σχεδιασμός προϊόντος, ενδυμασία, δωμάτιο ή οπτικό ύφος. Μια σύνθεση μπορεί να συνδυάζει την καρέκλα μιας εικόνας με το δωμάτιο μιας άλλης, διατηρώντας τη σιλουέτα και το υλικό της καρέκλας. Για υπάρχουσα σκηνή, προσδιορίστε το αντικείμενο που θα αλλάξει και τις λεπτομέρειες που θα διατηρηθούν, μαζί με κατεύθυνση φωτός και γεωμετρία του περιβάλλοντος.
Τα παραδείγματα της οικογένειας περιλαμβάνουν αλλαγές φόντου, αντικατάσταση αντικειμένων, συνθέσεις επίπλων, επεξεργασία κειμένου και συνεπείς χαρακτήρες. Μια πρωτότυπη περιγραφή τελικού οπτικού αρχείου θα μπορούσε να τοποθετεί παρεχόμενο ρολόι σε σκούρο διπλωμένο ύφασμα, να διατηρεί το σχέδιο καντράν και λουριού και να αλλάζει μόνο τον φωτισμό σε απαλό πλευρικό φως. Ονομάστε ποια πηγή παρέχει κάθε χαρακτηριστικό και ελέγξτε μαζί καντράν, σημάνσεις, υλικό και αντανακλάσεις του αποτελέσματος. Μια οδηγία διατήρησης θέτει τον στόχο· η επιστρεφόμενη εικόνα είναι το τεκμήριο για σύγκριση με αυτόν.
Κείμενο, χρώματα και ερμηνεία προτροπής
Ο οδηγός FLUX.2 συνιστά δομή θέμα–δράση–ύφος–πλαίσιο, με τα σημαντικά στοιχεία πρώτα. Προτείνει 10–30 λέξεις για γρήγορες ιδέες, 30–80 για συνήθη έργα και μεγαλύτερες περιγραφές για σύνθετη σκηνή. Πρόκειται για συστάσεις γραφής, όχι αυστηρά όρια συμφραζομένων. Φυσική γλώσσα και περιγραφές σκηνών με δομή JSON αποτελούν τεκμηριωμένους τρόπους οργάνωσης θεμάτων, τοποθέτησης, φωτός και ύφους. Μια δομημένη προτροπή είναι περιγραφή εικόνας, όχι υπόσχεση δομημένης απόκρισης κειμένου.
Για ορατά γράμματα, παραθέστε τη διατύπωση, ορίστε τη θέση και περιγράψτε την τυπογραφική ιεραρχία. Συνδέστε κάθε δεκαεξαδικό χρώμα με συγκεκριμένο αντικείμενο ή στοιχείο κειμένου· ένας χρωματικός κωδικός χωρίς ονομασμένο στόχο είναι ασαφής. Ο οδηγός κατασκευαστή χρησιμοποιεί θετικές περιγραφές αντί για μηχανισμό αρνητικής προτροπής. Για σκηνή προϊόντος με κενό χώρο για τίτλο, περιγράψτε απευθείας την κενή περιοχή και την επιθυμητή θέση της.
Η συγκεκριμένη προδιαγραφή αιτήματος [max] εφαρμόζει από προεπιλογή εμπλουτισμό προτροπής. Ο έλεγχος disable_pup απενεργοποιεί αυτή την επέκταση όταν μια προσεκτικά γραμμένη περιγραφή πρέπει να χρησιμοποιηθεί όπως δόθηκε. Αυτό διαφέρει από ισχυρισμό ότι κάθε λέξη θα εμφανιστεί αμετάβλητη στην τελική εικόνα. Διατηρήστε την πραγματική περιγραφή και την επιλεγμένη ρύθμιση μαζί με το αποτέλεσμα όταν αξιολογείτε αν μια απρόσμενη οπτική επιλογή προήλθε από την οδηγία ή την ερμηνεία της.
Έξοδος και χρήσιμο τελικό οπτικό αρχείο
Ο οδηγός της οικογένειας τεκμηριώνει εικόνες έως 4 megapixel, με ρητές διαστάσεις τουλάχιστον 64×64 και πολλαπλάσια του 16. Η σύσταση για συνήθη χρήση είναι έως 2 megapixel. Το συγκεκριμένο προφίλ [max] αναφέρει JPEG, PNG και WebP, με προεπιλογή JPEG και προαιρετικό τυχαίο seed. Επιλέξτε το σχήμα εξόδου για την επιθυμητή θέση πριν οργανώσετε τη σύνθεση. Η δημιουργία εικόνας του μοντέλου διαφέρει από την αλλαγή μεγέθους ενός ήδη ολοκληρωμένου οπτικού αρχείου.
Διατηρήστε την εικόνα, τις αναφορές, την προτροπή, τις διαστάσεις και την ταυτότητα μοντέλου όταν επιλέγετε την τελική έκδοση. Ο οδηγός FLUX.2 του παραγωγού προειδοποιεί ότι ο υπογεγραμμένος σύνδεσμος αποτελέσματος είναι προσωρινός, με περιθώριο ανάκτησης δέκα λεπτών. Εξετάστε μικρό κείμενο, ταυτότητα αντικειμένων, διάταξη, φως και κάθε γεγονός από αναζήτηση στο προβλεπόμενο μέγεθος προβολής. Το χρήσιμο παραδοτέο είναι το επιλεγμένο οπτικό αποτέλεσμα με αρκετό πλαίσιο για ακριβή επόμενη αναθεώρηση, και όχι μια σκηνή της οποίας οι σημαντικές λεπτομέρειες δεν συγκρίθηκαν ποτέ με την περιγραφή.
Ailoot Ultra · Εικόνες POST /v1/images/generations black-forest-labs/flux.2-max
black-forest-labs/flux.2-maxΕισαγωγή
Το FLUX.2 [max] είναι το μοντέλο εικόνας της Black Forest Labs για απαιτητικά τελικά οπτικά αρχεία και συνεπείς επεξεργασίες. Οι τεκμηριωμένες προδιαγραφές του συνδυάζουν οπτικές αναφορές, λεπτομερή έλεγχο σκηνής και τεκμηρίωση από τον ιστό για επίκαιρα θέματα, με έξοδο έως 4 megapixel.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Εικόνες POST /v1/images/generations
- Είσοδος
text,image- Έξοδος
image
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια black-forest-labs/flux.2-max | Προεπιλογή— |
Πεδίο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 Μέγιστο πλήθος στοιχείων: 8 | Προεπιλογή— |
Πεδίο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.14 ανά μεγαπίξελ εικόνας εξόδου |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.14 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το 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-max', '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-max
Εναλλακτικές διαδρομές μεθόδων
/v1/images
Σχετικά ID μοντέλων
FAQ · Black Forest Labs: FLUX.2 Max
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/images/generations·black-forest-labs/flux.2-max:text,image→image- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/images/generations·black-forest-labs/flux.2-max:model,prompt,aspect_ratio,output_format,n,input_references,provider- Ποια όρια ισχύουν;
POST /v1/images/generations·black-forest-labs/flux.2-max:n.minimum:1;n.maximum:1