μοντέλα

Black Forest Labs: FLUX.3 Image

Markdown · JSON

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 /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 · Εικόνες

curl
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}/content
  • GET /v1/media/assets
  • GET /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 μοντέλων

black-forest-labs/flux-3-image

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

Περισσότερες λεπτομέρειες

Συνδέστε το Ailoot με Claude Code, OpenCode, Hermes ή τη δική σας εφαρμογή.

Η εταιρεία και το χαρτοφυλάκιο έργων της

Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.

Αγοράστε token με έκπτωση.

Έκπτωση συνδρομής για τακτική χρήση. Προωθητικοί κωδικοί — έως 50% στην αγορά token.

Συνδρομή
Επιλέξτε πρόγραμμα με έκπτωση για τα τακτικά αιτήματά σας.
Προωθητικός κωδικός έως 50%
Εισαγάγετε τον κωδικό στην αγορά. Η τιμή επανυπολογίζεται σύμφωνα με την ενεργή προσφορά.
Δαπάνες στο ιστορικό
Μοντέλο, token και ποσό αποθηκεύονται για κάθε αίτημα.

Επιλέξτε συνδρομή · Δείτε τιμές μοντέλων

Συνδέστε το API με το προϊόν που πουλάτε.

SaaS, εφαρμογές και bot — σύμφωνα με τη δημόσια προσφορά και τη σύμβαση άδειας χρήσης Ailoot. Για μεταπώληση ζητήστε σχετική άδεια.

Εμπορική εφαρμογή
Ενσωματώστε δημιουργία κειμένου, εικόνων, βίντεο και ήχου στις πληρωμένες λειτουργίες της υπηρεσίας σας.
Άδεια για μεταπωλητή
Στείλτε περιγραφή έργου και τρόπο πρόσβασης. Ζητήστε γραπτούς όρους χρήσης και μεταπώλησης.
Έγγραφα στον ιστότοπο
Δημόσια προσφορά, σύμβαση άδειας χρήσης και πολιτική επεξεργασίας δεδομένων είναι διαθέσιμες πριν τη σύνδεση.

Ζητήστε άδεια μεταπώλησης · Δημόσια προσφορά και σύμβαση άδειας χρήσης