μοντέλα

Black Forest Labs: FLUX.2 Pro

Markdown · JSON

Black Forest Labs: FLUX.2 Pro

Το FLUX.2 [pro] είναι το μοντέλο εικόνας παραγωγής της Black Forest Labs για δημιουργία με βάση κείμενο και επεξεργασία με καθοδήγηση αναφορών. Οι τεκμηριωμένες προδιαγραφές του συνδυάζουν φωτορεαλιστικές λεπτομέρειες και έλεγχο κειμένου και χρώματος, με κοινό όριο pixel για αναφορές/έξοδο και εικόνες έως 4 megapixel.

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Το FLUX.2 [pro] είναι το μοντέλο δημιουργίας και επεξεργασίας εικόνων της Black Forest Labs με προσανατολισμό στην παραγωγή. Ο κατασκευαστής το παρουσιάζει ως προεπιλεγμένη επιλογή για τις περισσότερες οπτικές εργασίες FLUX.2: δημιουργία νέας εικόνας από κείμενο ή αναθεώρηση σκηνής με οπτικές αναφορές. Οι δυνατότητες της οικογένειας περιλαμβάνουν φωτορεαλιστικά υλικά και φωτισμό, ευανάγνωστο κείμενο, οδηγίες ακριβούς χρώματος και συνεπή θέματα μεταξύ σχετικών επεξεργασιών. Το επιστρεφόμενο παραδοτέο είναι εικόνα για χρήση σε σκηνή προϊόντος, εκδοτική σύνθεση, σχεδιαστική ιδέα ή οπτική επικοινωνία.

Προετοιμάστε μια περιγραφή παραγωγής

Ξεκινήστε με το θέμα, τι κάνει ή πώς είναι τοποθετημένο, το ύφος και το περιβάλλον ή το φως. Ο οδηγός προτροπών του κατασκευαστή δίνει μεγαλύτερη προσοχή στις πρώτες λέξεις και συνιστά το ουσιώδες θέμα και η δράση να προηγούνται των διακοσμητικών λεπτομερειών. Προτείνει 10–30 λέξεις για γρήγορες ιδέες και 30–80 για συνήθη έργα, με μεγαλύτερες περιγραφές για σύνθετες σκηνές. Αυτά τα εύρη αποτελούν οδηγίες σύνταξης προτροπών και όχι όριο συμφραζομένων κειμένου.

Μια πρωτότυπη περιγραφή καταλόγου θα μπορούσε να δείχνει φωτιστικό από βουρτσισμένο ατσάλι σε επιφάνεια τραπεζιού σε θερμό γκρι, σε λήψη τριών τετάρτων που αναδεικνύει τον διακόπτη και το καπέλο. Προσδιορίστε την επιφάνεια, τον φωτισμό και την οπτική γωνία που κάνουν αναγνωρίσιμο το προϊόν. Για infographic ή εικόνα μάρκετινγκ, οριστικοποιήστε πρώτα το ορατό κείμενο και την ιεραρχία· παραθέστε τον ακριβή τίτλο, ορίστε τη θέση του και ονομάστε το ύφος και το μέγεθος των γραμμάτων. Εξετάστε ετικέτες, ποσότητες και λεπτομέρειες προϊόντος στο τελικό μέγεθος προβολής.

Ο οδηγός της οικογένειας τεκμηριώνει προτροπές τόσο σε φυσική γλώσσα όσο και με δομή JSON. Μια δομημένη περιγραφή σκηνής μπορεί να διατηρεί θέμα, φόντο, φως και σύνθεση σε χωριστά πεδία, ώστε κάθε απαίτηση να αναθεωρείται καθαρά. Υποστηρίζει επίσης περιγραφές με δεκαεξαδικά χρώματα: συνδέστε τον κωδικό με το συγκεκριμένο αντικείμενο ή κείμενο που θα χρωματιστεί. Περιγράψτε θετικά την επιθυμητή εμφάνιση, επειδή η τεκμηριωμένη ροή προτροπών FLUX.2 δεν παρέχει αρνητικές προτροπές.

Επεξεργασία με αναφορές και κοινό όριο pixel

Το συγκεκριμένο προφίλ αιτήματος [pro] προσφέρει οκτώ θέσεις εικόνων αναφοράς· η διαδραστική διεπαφή του κατασκευαστή υποστηρίζει χωριστά δέκα. Αναθέστε σε κάθε εικόνα ρόλο, όπως εμφάνιση θέματος, ενδυμασία, σχεδιασμός προϊόντος, δωμάτιο ή ύφος. Για υπάρχουσα σκηνή, δηλώστε το στοιχείο που θα αλλάξει και ποια σύνθεση, περιβάλλον και οπτικές λεπτομέρειες πρέπει να παραμείνουν. Τα δημοσιευμένα παραδείγματα περιλαμβάνουν συνθέσεις επίπλων, αλλαγές φόντου ή καιρού, αντικαταστάσεις αντικειμένων και αναθεωρήσεις κειμένου.

Η χωρητικότητα αναφορών εξαρτάται επίσης από το μέγεθος εξόδου. Ο οδηγός [pro] του παραγωγού ορίζει συνολικό όριο 9 megapixel για είσοδο και έξοδο. Τα παραδείγματά του επιτρέπουν οκτώ αναφορές με έξοδο 1 megapixel και επτά με έξοδο 2 megapixel, μειώνοντας τη χωρητικότητα αναφορών όσο μεγαλώνει το ζητούμενο αποτέλεσμα. Σχεδιάστε μαζί το σύνολο πηγών και την έξοδο, αντί να θεωρείτε διαθέσιμο το μέγιστο πλήθος θέσεων για κάθε μέγεθος εξόδου. Χρησιμοποιήστε τις αναφορές που καθορίζουν αναγκαίες πληροφορίες και προσδιορίστε την επιθυμητή συμβολή τους.

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

Επέκταση προτροπής και σταθερά προφίλ έναντι Preview

Η συγκεκριμένη προδιαγραφή [pro] ενεργοποιεί από προεπιλογή τον εμπλουτισμό προτροπής. Ο έλεγχος disable_pup σταματά αυτή την επέκταση όταν μια προσεκτικά γραμμένη οδηγία πρέπει να χρησιμοποιηθεί όπως δόθηκε. Διατηρήστε την επιλεγμένη ρύθμιση όταν συγκρίνετε εκδόσεις, επειδή η ίδια σύντομη ιδέα και μια εμπλουτισμένη περιγραφή αποτελούν διαφορετικές εισόδους δημιουργίας. Πρόκειται για έλεγχο του προφίλ κατασκευαστή, και όχι εγγύηση ότι κάθε ζητούμενη λεπτομέρεια εμφανίζεται σωστά.

Η τεκμηρίωση διακρίνει το απλό endpoint [pro] ως σταθερό στιγμιότυπο από το [pro] Preview, στο οποίο εισάγονται μεταγενέστερες βελτιώσεις μοντέλου. Η δομή αιτήματος και απόκρισής τους είναι ίδια, ενώ τα υποκείμενα βάρη διαφέρουν. Κρατήστε το ακριβές επιλεγμένο προφίλ μαζί με την εικόνα και τις αναφορές. Η χωριστή ετικέτα Preview δεν πρέπει να αντικαθιστά σιωπηρά μια απλή επιλογή [pro] όταν μια αναθεώρηση εξαρτάται από την ίδια τεκμηριωμένη επιλογή μοντέλου.

Διαστάσεις, μορφές και το επιλεγμένο οπτικό αρχείο

Ο οδηγός της οικογένειας τεκμηριώνει έξοδο έως 4 megapixel, με ρητές διαστάσεις τουλάχιστον 64×64 και πολλαπλάσια του 16. Συνιστά έως 2 megapixel για τις περισσότερες χρήσεις. Πλάτος και ύψος καθορίζουν το επιθυμητό κάδρο· μια τετράγωνη εικόνα προϊόντος, μια κάθετη διάταξη και μια πλατιά εκδοτική σκηνή κατανέμουν διαφορετικά τον χώρο. Το συγκεκριμένο αίτημα αναφέρει έξοδο JPEG, PNG και WebP, με προεπιλογή JPEG και προαιρετικό seed.

Το προφίλ [max] έχει χωριστή δυνατότητα τεκμηρίωσης μέσω αναζήτησης, ενώ το [flex] εκθέτει βήματα δειγματοληψίας και guidance και το [klein] έχει μικρότερο προφίλ τεσσάρων αναφορών. Επιλέξτε έκδοση με βάση την απαιτούμενη εργασία, αντί να μεταφέρετε αυτούς τους ελέγχους στο [pro]. Για το επιλεγμένο οπτικό αρχείο, κρατήστε την πραγματική εικόνα, την τελική προτροπή, τις αναφορές, τις διαστάσεις και την ετικέτα μοντέλου. Οι υπογεγραμμένοι σύνδεσμοι αποτελεσμάτων FLUX.2 του παραγωγού λήγουν μετά από δέκα λεπτά, επομένως ανακτήστε την εικόνα αντί να βασίζεστε στην προσωρινή διεύθυνσή της. Ελέγξτε την ταυτότητα θέματος, τα χρώματα, το κείμενο, τη σύνθεση και τις επεξεργασμένες λεπτομέρειες πριν τοποθετήσετε το αποτέλεσμα στο υλικό που βλέπει ο πελάτης.

Ailoot Ultra · Εικόνες POST /v1/images/generations black-forest-labs/flux.2-pro

black-forest-labs/flux.2-pro

Black Forest Labs /black-forest-labs/flux.2-pro

Εισαγωγή

Το FLUX.2 [pro] είναι το μοντέλο εικόνας παραγωγής της Black Forest Labs για δημιουργία με βάση κείμενο και επεξεργασία με καθοδήγηση αναφορών. Οι τεκμηριωμένες προδιαγραφές του συνδυάζουν φωτορεαλιστικές λεπτομέρειες και έλεγχο κειμένου και χρώματος, με κοινό όριο pixel για αναφορές/έξοδο και εικόνες έως 4 megapixel.

Αποδεκτές είσοδοι
Κείμενο · Εικόνες
Αποτελέσματα
Εικόνες

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot Ultra · Εικόνες POST /v1/images/generations
Είσοδος
text, image
Έξοδος
image
ΠεδίοΤύποςΑπαίτησηΤιμές και όριαΠροεπιλογή
ΠεδίοmodelΤύποςstringΑπαίτησηΥποχρεωτικόΤιμές και όρια
black-forest-labs/flux.2-pro
Προεπιλογή—
Πεδίο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.06 ανά μεγαπίξελ εικόνας εξόδου
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίαςΠίνακας χρεώσεων—Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργίαΜονάδα τιμολόγησης—Χρέωση
Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.06 εκτίμηση πριν από τη δημιουργία

Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

Το 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.2-pro', '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.2-pro

Εναλλακτικές διαδρομές μεθόδων

/v1/images

Σχετικά ID μοντέλων

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro
Ποιες είσοδοι και αποτελέσματα διατίθενται;

POST /v1/images/generations · black-forest-labs/flux.2-pro: text, image → image

Ποια πεδία χρησιμοποιεί το αίτημα;

POST /v1/images/generations · black-forest-labs/flux.2-pro: model, prompt, aspect_ratio, output_format, n, input_references, provider

Ποια όρια ισχύουν;

POST /v1/images/generations · black-forest-labs/flux.2-pro: n.minimum: 1; n.maximum: 1

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

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

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

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

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

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

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

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

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

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

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

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