Black Forest Labs: FLUX.3 Image
Το FLUX 3 Image δημιουργεί και επεξεργάζεται εικόνες από γραπτή περιγραφή και έως δέκα αναφορές. Προσθέτει πλαίσια οριοθέτησης μέσω προτροπών για σύνθεση και τοπικές αλλαγές, τεκμηρίωση από ιστό και εικόνες και πέντε κατηγορίες ανάλυσης.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το FLUX 3 Image είναι το μοντέλο δημιουργίας και επεξεργασίας εικόνων της Black Forest Labs με ρητό έλεγχο σύνθεσης. Μια περιγραφή κειμένου μπορεί να δημιουργήσει νέα σκηνή· οι παρεχόμενες εικόνες μπορούν να καθορίζουν θέμα, σκηνή προς αναθεώρηση ή αρκετά στοιχεία προς συνδυασμό. Τα πλαίσια οριοθέτησης επιτρέπουν στην περιγραφή να ορίζει πού ανήκει κάθε στοιχείο και ποια μέρη υπάρχουσας εικόνας πρέπει να αλλάξουν. Το αποτέλεσμα είναι εικόνα, με τη ζητούμενη σκηνή, το κείμενο και τη διάταξη προς έλεγχο.
Δημιουργήστε σκηνή ή δώστε οδηγία επεξεργασίας
Για νέα εικόνα, περιγράψτε το θέμα, τη δράση ή στάση, το περιβάλλον, το φως και το κάδρο. Βάλτε την ακριβή διατύπωση μέσα στην εικόνα σε εισαγωγικά και δηλώστε πού εμφανίζεται. Μια πρωτότυπη περιγραφή προϊόντος θα μπορούσε να δείχνει κόκκινη κούπα κάμπινγκ σε ανοιχτόχρωμη πέτρινη επιφάνεια, με μεγάλο τίτλο από πάνω και απαλό πρωινό φως που αναδεικνύει το χερούλι. Ορίστε τη σχέση τίτλου, προϊόντος και φόντου, αντί να δίνετε άσχετες λέξεις ύφους.
Για επεξεργασία, προσδιορίστε το συγκεκριμένο αντικείμενο και την αλλαγή: αλλάξτε χρώμα στην κούπα, αντικαταστήστε ετικέτα, μετακινήστε φιγούρα ή αλλάξτε ύφος στη σκηνή. Μία επεξεργασία δεν απαιτεί χειροκίνητα σχεδιασμένο πλαίσιο. Η τεκμηριωμένη ροή επεκτείνει την οδηγία πριν τη δημιουργία και μπορεί να εντοπίσει το ονομασμένο στοιχείο και να προσθέσει αυτόματα πλαίσιο. Η επιστρεφόμενη εμπλουτισμένη προτροπή καταγράφει αυτή την ερμηνεία, χρήσιμη όταν μια οδηγία επιλέγει λάθος αντικείμενο ή εισάγει ανεπιθύμητη λεπτομέρεια.
Συνδυάστε και προετοιμάστε εικόνες αναφοράς
Το συγκεκριμένο προφίλ παραγωγού δέχεται από μία έως δέκα αναφορές, παρεχόμενες ως URL εικόνων ή κωδικοποιημένα δεδομένα εικόνας. Καθεμία πρέπει να είναι τουλάχιστον 256×256 pixel και όχι μεγαλύτερη από 16 megapixel. Ονομάστε μια αναφορά βάσει θέσης ή ορατού περιεχομένου και εξηγήστε τον ρόλο της: το πρόσωπο από Image 1, το σακάκι από Image 2 και το δωμάτιο από Image 3. Μια εικόνα αναφοράς είναι πηγή οπτικών πληροφοριών, όχι οδηγία αντιγραφής κάθε άσχετης λεπτομέρειας που περιέχει.
Η ρύθμιση αναλογίας διαστάσεων έχει προεπιλογή auto. Στην προδιαγραφή αιτήματος, μια αναλογία που ζητείται στην προτροπή έχει προτεραιότητα· διαφορετικά η πρώτη αναφορά καθορίζει το κάδρο, με τετράγωνη έξοδο ως εναλλακτική όταν ούτε αναφορά ούτε ζητούμενο σχήμα το ορίζουν. Για σύνθεση, τοποθετήστε πρώτη την αναφορά της επιθυμητής σκηνής ή επιλέξτε ρητά την αναλογία. Κρατήστε τις αρχικές εικόνες και τη σειρά τους μαζί με το αποτέλεσμα, ώστε μεταγενέστερη αναθεώρηση να χρησιμοποιεί την ίδια οπτική αφετηρία.
Τοποθετήστε στοιχεία με πλαίσια οριοθέτησης
Μια προτροπή διάταξης συνδυάζει λεζάντα με πίνακα JSON από γραμμές στοιχείων. Η λεζάντα ονομάζει ένα στοιχείο μέσω δείκτη όπως <cup_1>· η γραμμή περιέχει id, bbox και desc. Οι συντεταγμένες είναι ακέραιοι από 0 έως 1000 στη σειρά [top, left, bottom, right], με αφετηρία την επάνω αριστερή γωνία. Για παράδειγμα, το [0, 0, 500, 500] περιγράφει το επάνω αριστερό τέταρτο ανεξάρτητα από τις διαστάσεις pixel της εικόνας. Χρησιμοποιήστε την αναλογία για την οποία σχεδιάστηκε η διάταξη, επειδή αυτό το πλέγμα συντεταγμένων τεντώνεται μαζί με το κάδρο.
Μια γραμμή επεξεργασίας χρησιμοποιεί αντίθετα from, src_bbox και tgt_bbox μαζί με το αναγνωριστικό και την περιγραφή. Το ref_image_0 σημαίνει την πρώτη παρεχόμενη εικόνα. Ίδια πλαίσια πηγής και στόχου σταθεροποιούν ένα στοιχείο· διαφορετικά πλαίσια το μετακινούν ή αλλάζουν το μέγεθός του. Νέα γραμμή χωρίς πηγή παράγει την περιγραφή της στη θέση στόχου, επιτρέποντας προσθήκες, αντικαταστάσεις ή αλλαγές χρώματος. Γραμμή πηγής χωρίς στόχο αφαιρεί το στοιχείο. Δηλώστε προσθήκες και αφαιρέσεις τόσο στη γραπτή οδηγία όσο και στις γραμμές και διατηρήστε γραμμές σταθεροποίησης για λεπτομέρειες που πρέπει να μείνουν στη θέση τους.
Δώστε στα γράμματα δικό τους πλαίσιο και παραθέστε την ακριβή διατύπωσή τους στο desc. Τα πλαίσια καθοδηγούν θέση και κλίμακα· δεν είναι μάσκες αποκοπής, οπότε ένα στοιχείο μπορεί να εκτείνεται πέρα από το ορθογώνιο. Ο κατασκευαστής αναφέρει ότι νέα αντικείμενα σε πλαίσια περίπου 40×25 pixel συχνά δεν εμφανίζονταν στα παραδείγματά του. Αφήστε αρκετό ορατό χώρο και εξετάστε τα επεξεργασμένα όρια. Τα pixel εκτός στόχου συνήθως παραμένουν σταθερά, αλλά σκιές, αντανακλάσεις και κοντινός φωτισμός μπορεί και πάλι να αλλάξουν.
Τεκμηρίωση, κατηγορίες εξόδου και χρήσιμα αρχεία
Το τεκμηριωμένο προφίλ ενεργοποιεί από προεπιλογή την τεκμηρίωση, επιτρέποντας σε αναζήτηση ιστού και εικόνων να ενημερώνει τη δημιουργία. Μπορεί να απενεργοποιηθεί για περιγραφή που πρέπει να χρησιμοποιεί μόνο το παρεχόμενο κείμενο και τις αναφορές της. Για θέμα πραγματικού κόσμου, προσδιορίστε καθαρά την τοποθεσία, το γεγονός ή το αντικείμενο και κρατήστε το πραγματολογικό περιεχόμενο χωριστό από την καλλιτεχνική απόδοση. Εικόνες που ενημερώνονται από αναζήτηση εξακολουθούν να χρειάζονται σύγκριση με έγκυρο υλικό όταν απαιτείται ακρίβεια σε μια ετικέτα, ένα αντικείμενο ή ένα απεικονιζόμενο γεγονός.
Οι πέντε κατηγορίες ανάλυσης είναι 768sq, 1k, 1.5k, 2k και 4k, με προεπιλογή 1k. Αντιπροσωπεύουν βαθμίδες ίσου εμβαδού pixel, επομένως το ακριβές πλάτος και ύψος εξαρτώνται από την επιλεγμένη αναλογία. Δεκαπέντε σταθερές αναλογίες εκτείνονται από 21:9, μέσω τετράγωνων και κάθετων μορφών, έως 9:21. Το προφίλ αυτού του μοντέλου ελέγχει το μέγεθος μέσω αναλογίας και ανάλυσης· δεν εκθέτει τα πεδία seed, width ή height των προφίλ αιτήματος FLUX.2. Ο τεκμηριωμένος επιλογέας έκδοσης ονομάζει επί του παρόντος μια μεταβαλλόμενη έκδοση, αντί να καθορίζει χρονολογημένη αντιστοίχιση βαρών προμηθευτή.
Η ροή παραγωγού επιστρέφει εικόνα μετά από ασύγχρονη επεξεργασία, μαζί με την εμπλουτισμένη προτροπή. Ο υπογεγραμμένος σύνδεσμος λήψης εικόνας ισχύει για μία ώρα. Διατηρήστε την πραγματική εικόνα, την τελική προτροπή και τις αναφορές αντί να βασίζεστε σε προσωρινό σύνδεσμο. Για ελεγμένο οπτικό αρχείο, συγκρίνετε το ζητούμενο κείμενο, την τοποθέτηση αντικειμένων, την ταυτότητα αναφορών και την αλλαγμένη περιοχή στο προβλεπόμενο μέγεθος προβολής. Μια ολοκληρωμένη δημιουργία είναι η αφετηρία για τον έλεγχο αυτών των οπτικών απαιτήσεων.
Ailoot Ultra · Εικόνες POST /v1/images/generations black-forest-labs/flux-3-image
black-forest-labs/flux-3-image
black-forest-labs/flux-3-imageΕισαγωγή
Το FLUX 3 Image δημιουργεί και επεξεργάζεται εικόνες από γραπτή περιγραφή και έως δέκα αναφορές. Προσθέτει πλαίσια οριοθέτησης μέσω προτροπών για σύνθεση και τοπικές αλλαγές, τεκμηρίωση από ιστό και εικόνες και πέντε κατηγορίες ανάλυσης.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Εικόνες POST /v1/images/generations
- Είσοδος
text,image- Έξοδος
image
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια black-forest-labs/flux-3-image | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 768, 1K, 1.5K, 2K, 4K | Προεπιλογή— |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 1 | Προεπιλογή— |
Πεδίοinput_references | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 0 Μέγιστο πλήθος στοιχείων: 10 | Προεπιλογή— |
Πεδίο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 |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.082 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το 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-3-image', '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-3-image
Εναλλακτικές διαδρομές μεθόδων
/v1/images
Σχετικά ID μοντέλων
FAQ · Black Forest Labs: FLUX.3 Image
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/images/generations·black-forest-labs/flux-3-image:text,image→image- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/images/generations·black-forest-labs/flux-3-image:model,prompt,resolution,aspect_ratio,n,input_references,provider- Ποια όρια ισχύουν;
POST /v1/images/generations·black-forest-labs/flux-3-image:n.minimum:1;n.maximum:1