Crea con CometAPITi serve una sola API per più modelli?Testa il flusso di lavoro in Playground, poi crea una chiave API quando modello e costo sono adatti al tuo caso d'uso.
Come utilizzare l'API di immagini FLUX 3 con CometAPI
Utilizza FLUX 3 Image su CometAPI per la generazione e la modifica. Scopri i parametri delle immagini, la gestione dei job asincroni, esempi di prompt e i prezzi.
Crea fotografie di prodotto, poster ed edit basati su riferimenti con FLUX 3 Image, disponibile tramite CometAPI come flux-3-image, con prezzi a partire da $0.0384 per richiesta. Questa guida ti accompagna nella scelta delle impostazioni immagine, nella preparazione di una richiesta, nella gestione di un job asincrono e nella revisione dell’immagine finale. Ti serviranno un account CometAPI, una chiave API e la configurazione di richiesta FLUX 3 Image fornita per il tuo account.
Key Takeaways
Usa il text-to-image per nuove composizioni ed editing guidato da riferimenti quando un prodotto o un soggetto devono restare riconoscibili.
Usa un bozzetto piccolo per rivedere la composizione prima di investire in un’immagine finale più grande.
Utilizza le credenziali CometAPI e lo schema di richiesta specifico del modello; chiavi native BFL ed esempi appartengono a un’integrazione separata.
Stima i costi a partire dalla tariffa CometAPI applicabile, poi misura la spesa per ogni deliverable accettato.
Revisionato per chiarezza, attribuzione delle fonti e terminologia API aggiornata.
Completa un ciclo di invio, recupero del risultato, download e revisione visiva prima di avviare un batch.
What Is FLUX 3 Image API?
FLUX 3 Image è il modello di Black Forest Labs per creare e rielaborare immagini statiche. Un prompt testuale descrive una nuova scena; le immagini di riferimento forniscono materiale visivo da preservare, combinare o modificare. Per un team e-commerce, può significare sviluppare una scena di prodotto a partire da un brief, quindi riutilizzare una foto di prodotto approvata cambiandone l’ambiente.
Scegli un workflow prima di scrivere il prompt. Per un nuovo visual, specifica soggetto, ambientazione, illuminazione e inquadratura. Per un edit, identifica l’immagine sorgente, definisci la modifica e indica quali dettagli devono rimanere intatti. Per una composizione con più riferimenti, assegna a ciascuno un ruolo in modo che identità di prodotto e stile visivo non vadano in conflitto.
FLUX 3 Image Specifications and API Parameters
Progetta l’immagine con le impostazioni seguenti. I controlli del modello seguono la BFL FLUX 3 Image API reference; autenticazione e instradamento delle richieste seguono la tua integrazione CometAPI. Usa i nomi di campo accettati dalla tua route CometAPI per FLUX 3 Image.
Capability / setting
What it controls
How to use it with CometAPI
Model identity
FLUX 3 Image; ID di catalogo flux-3-image
Usa la route specifica del modello e la convenzione di routing dell’esempio del tuo account.
Generation / prompt
La scena, la composizione o l’istruzione di editing
Parti da un solo soggetto chiaro e un solo output desiderato.
Reference images / native images
Un elenco ordinato di 1–10 immagini di riferimento, fornite come URL HTTP(S) o base64 nell’API nativa
Conferma il nome del campo del gateway, il formato d’input e il limite di riferimenti.
Aspect ratio / native aspect_ratio
Le proporzioni della tela. Con auto, un rapporto richiesto nel prompt ha priorità; altrimenti gli edit mantengono l’inquadratura del primo riferimento.
Scegli un rapporto per il formato di consegna e conferma i valori accettati.
Resolution / native resolution
Livelli nativi: 768sq, 1k (predefinito), 1.5k, 2k e 4k. Le dimensioni esatte dipendono dall’aspect ratio.
Per gli edit, match_input preserva la dimensione del primo riferimento, ridotta a 4 MP se maggiore; un aspect_ratio esplicito seleziona il livello più vicino. Larghezza e altezza hanno priorità.
Exact dimensions / width + height
Fornisci entrambi gli interi, ciascuno 256–6256 pixel. Hanno priorità su resolution e aspect_ratio. L’area totale è limitata a 16.822.272 pixel, o 4.194.304 pixel quando si usano riferimenti.
Usa dimensioni esplicite per un canvas fisso, ad esempio 1024 × 1280. Conferma che la tua route CometAPI accetti questi controlli nativi.
Layout control
Guida al posizionamento degli elementi mediante bounding box
Usa la sintassi di layout documentata quando il posizionamento esatto è importante.
Targeted edits
Modifiche a soggetti o regioni selezionati
Scegli le dimensioni in tre modi: un livello di resolution più aspect ratio, width più height per un canvas esatto, oppure match_input per un edit. Mantieni disponibile il riferimento originale così da poter confrontare inquadratura e dettagli dopo la generazione. L’endpoint nativo rifiuta campi non supportati; usa lo schema della route che stai chiamando.
FLUX.2 vs FLUX 3 Image
Dimension
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
Practical assessment
Use case
Ottimo text-to-image/editing, varianti per famiglie
Composizione d’immagine dettagliata ed edit che preservano i pixel
Confronta gli stessi prompt di brand
Resolution
Generazione ad alta risoluzione dipendente dalla variante
Showcase nativo esplicito 2K/4K
Ispeziona i dettagli fini a pieno zoom
Editing
Capacità multi-riferimento in varianti selezionate
Dimostrazioni di edit localizzati
Misura la deriva nelle aree non modificate
Cost
Varia per variante e piattaforma
Prezzi CometAPI per la configurazione selezionata
Confronta per immagine accettata
CometAPI access
Disponibile su CometAPI come FLUX 2 PRO e FLUX 2 MAX
Disponibile su CometAPI come flux-3-image
Valida la richiesta specifica del modello prima di cambiare il routing in produzione
Evaluation
Usa esattamente la variante oggi in uso
Esegui lo stesso prompt e set di riferimenti
Confronta output accettati e costo totale del workflow
Mantieni l’attuale integrazione FLUX.2 come baseline di confronto durante la valutazione di FLUX 3 Image. Esegui gli stessi brief e asset di riferimento in entrambi i workflow, quindi confronta gli output accettati, i tempi di lavorazione e il costo totale.
How Do You Generate an Image with FLUX 3 Image API in CometAPI?
1. Prerequisites
Registrati su CometAPI e crea una chiave API.
Imposta la variabile d’ambiente:
export COMETAPI_KEY="your_cometapi_key"
2. Endpoint
POST https://api.cometapi.com/flux/v1/flux-3-image
L’autenticazione usa un Bearer token (stile CometAPI). Le richieste sono asincrone per impostazione predefinita.
3. Basic text-to-image example (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Effettua il polling finché lo status non è "Ready". L’URL dell’immagine compare in result.sample (scaricalo subito; gli URL firmati sono temporanei).
Per attendere in modo sincrono nella stessa richiesta, aggiungi "async": false al body (mantieni la connessione aperta; usa un timeout client generoso).
5. Python example (submit + poll)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image supporta sia puro text-to-image sia editing/multi-riferimento nello stesso endpoint: basta includere images e descrivere nel prompt come usarle (nessun campo “mode” separato).
Alternative: OpenAI-compatible route
Puoi anche provare l’endpoint unificato delle immagini con l’ID del modello:
POST https://api.cometapi.com/v1/images/generations
(Il percorso nativo `/flux/v1/...` è preferibile per tutti i parametri FLUX 3.)
### Tips
* Verifica disponibilità attuale e prezzi esatti sulla pagina del modello FLUX 3 Image di CometAPI.
* Scarica sempre rapidamente l’URL in result.sample.
* Per l’elenco più recente dei parametri o esempi del playground, consulta la documentazione Flux di CometAPI e la FLUX 3 Image reference ufficiale di Black Forest Labs.
Questo rispecchia il flusso ufficiale BFL utilizzando però l’autenticazione e l’infrastruttura unificata di CometAPI.
## How to Prompt FLUX 3 Image? Examples
### Example: Product Photography Prompt
Usa questo prompt per un primo test di fotografia di prodotto.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Sostituisci il valore di prompt in request.json con questo brief, mantenendo il body di richiesta previsto dalla tua route CometAPI. Un canvas 4:5 è adatto a un’inquadratura prodotto verticale. Se la tua route accetta i controlli di dimensione nativi, 1024 × 1280 è un’opzione esatta 4:5; fornisci entrambi i valori insieme.
Inizia con un bozzetto piccolo e verifica silhouette del flacone, etichetta, riflessi e oggetti extra. Se l’identità del prodotto è cruciale, usa un riferimento del prodotto invece di aspettarti che un prompt testuale lo ricostruisca. Registra prompt e impostazioni di output prima di apportare modifiche.
### Example: Typography and Poster Layout
Prompt per poster con titolo esplicito.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Usa questo brief come prompt nella tua richiesta CometAPI e scegli un canvas verticale. Inizia con un bozzetto per controllare la posizione del titolo e la disposizione dei personaggi, poi aumenta le dimensioni di output per l’elaborato finale.
Tratta la correttezza delle lettere come condizione di accettazione misurabile. Rivedi ogni lettera e segno di punteggiatura nell’output a risoluzione finale; immagini d’impatto non garantiscono zero errori sul tuo testo di brand specifico.
## How to Edit Images with References
Per un edit, descrivi sia la modifica desiderata sia i dettagli da preservare. L’API nativa FLUX 3 Image accetta riferimenti in images; mappali al campo d’ingresso corrispondente nell’esempio CometAPI. Metti per primo il riferimento del prodotto e mantieni quell’ordine coerente nel prompt.
### Single-Image Editing: Change the Background, Preserve the Product
Tieni edit.py accanto a submit.py, poll.py e download.py. Imposta PRODUCT_IMAGE_URL su una foto prodotto HTTPS pubblicamente accessibile, quindi esegui python edit.py. L’esempio seguente richiede una route che accetta l’array nativo images. Usa un body di richiesta per l’editing senza campi sorgente in conflitto e cambia la mappatura se il tuo esempio CometAPI usa un input diverso. Per riprendere un task di editing salvato, esegui python poll_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Scegli una foto prodotto nitida, con etichetta leggibile e silhouette chiara. Invia l’immagine nel formato d’ingresso accettato dalla tua route CometAPI. Se quella route supporta l’impostazione nativa di resolution, usa match_input per mantenere inquadratura e dimensioni del riferimento nei limiti di editing del modello.
La galleria BFL mostra un edit localizzato con l’aggiunta di due subacquei. Questi asset ufficiali “prima e dopo” illustrano cosa ispezionare; non sono output di una richiesta CometAPI eseguita per questo articolo.
Esempio ufficiale di editing BFL, prima: la scena subacquea originale con un subacqueo.
Esempio ufficiale di editing BFL, dopo: alla scena sono stati aggiunti due subacquei. Ispeziona lo sfondo invariato oltre ai nuovi soggetti.
### Multi-Image Reference Editing: Combine Style and Product Identity
Mantieni il prodotto per primo e il riferimento di luce/stile per secondo. Imposta PRODUCT_IMAGE_URL e STYLE_IMAGE_URL, salva il codice sotto come multi_edit.py accanto ai tre file client ed esegui python multi_edit.py. Questo esempio richiede una route che accetti almeno due riferimenti in images. Parti da un body di richiesta per l’editing senza campi sorgente in conflitto. Riprendi un job salvato con python poll_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Allega entrambi i riferimenti usando il formato CometAPI specifico del modello. Verifica prima se il prodotto ha mantenuto la propria identità; poi valuta se il secondo riferimento ha contribuito la luce e il colore desiderati. Se introduce anche oggetti o lettering indesiderati, semplifica quel riferimento o rendi il prompt più esplicito.
## How to Use Bounding Boxes for Layout Control
Usa le box quando il flacone e il titolo devono occupare regioni prevedibili. Scrivi una didascalia della scena con un ID per ciascun elemento, poi aggiungi un array JSON al prompt. Il formato BFL usa bbox in ordine [top, left, bottom, right] su una griglia 0–1000; le box appartengono al prompt, non a un campo API separato.
L’esempio seguente riserva spazio a un titolo sopra il flacone. Mantieni un’impostazione di output verticale in request.json e salva questo file come layout.py accanto a submit.py. Esegui python layout.py, poi python poll_download.py layout-task.json. Usa una route che supporti questa sintassi di layout; ispeziona il risultato per verificare che flacone e titolo occupino le regioni previste.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Mantieni l’aspect ratio coerente con il layout. Le box guidano il posizionamento piuttosto che ritagliare un oggetto con un bordo rigido. Ispeziona l’ortografia e la spaziatura del titolo nell’immagine salvata; aggiungi il lettering di brand finale in un tool di design quando la tipografia esatta è essenziale.
## How Much Does FLUX 3 Image API Cost?
CometAPI offre FLUX 3 Image a partire da $0.0384 per richiesta (9 novembre 2026). Usa questa tariffa iniziale per un budget preliminare, poi applica la tariffa mostrata per la configurazione selezionata. Gli esempi sotto assumono che ogni richiesta fatturata usi la tariffa iniziale.
| Billed requests | Assumed rate / request | Illustrative cost |
| --------------- | ---------------------- | ----------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Controlla la tariffa per la configurazione e l’account selezionati prima di impegnare un batch. Il prezzo pubblico di partenza non stabilisce il prezzo di ogni risoluzione o opzione di editing. Traccia i tentativi creativi rifiutati oltre agli output approvati: se spendi $3.84 per 100 richieste fatturate e approvi 80 deliverable, il costo API per deliverable accettato è $0.048, prima della revisione umana e dell’archiviazione. Questo è un calcolo illustrativo, non un tasso di accettazione misurato.
### Resolution Choices by Workflow
| Workflow | First test | Approval check |
| ----------------------------- | ------------------------------------------------ | ------------------------------------------------- |
| Prompt exploration | Livello supportato minimo utile | Composizione e posizionamento del soggetto |
| E-commerce product images | Una bozza con il crop desiderato | Geometria del prodotto, etichette e dettagli dei bordi |
| Campaign or editorial artwork | Prima bozza; output più grande dopo approvazione layout | Tipografia e dettagli alla dimensione di consegna |
| Reference-based edits | Impostazione supportata adatta alla sorgente | Aree invariate, identità del prodotto e illuminazione |
## When Should You Use FLUX 3 Video Instead?
Usa FLUX 3 Image per asset statici come un hero di prodotto, un poster o un frame di campagna. Se il deliverable richiede movimento, valuta FLUX 3 Video su CometAPI, elencato con l’ID modello separato flux-3. Il suo workflow video usa impostazioni e fatturazione specifiche per il video. Mantieni separate le richieste per immagini e video; durata, audio e controlli dei frame video non appartengono a una richiesta per immagini statiche.
Per una campagna con entrambi i formati, approva prima la composizione dell’immagine statica, poi prepara separatamente il brief per il motion. Controlla i requisiti di input di riferimento del modello video prima di riutilizzare un’immagine approvata come materiale sorgente.
## Conclusion
Inizia con un brief di prodotto e un piccolo job immagine. Invialo tramite la tua route CometAPI FLUX 3 Image, salva il task ID, recupera l’immagine completata e rivedi il risultato prima di scalare. Usa width e height quando ti serve un canvas esatto, oppure match_input per un edit basato su riferimento quando supportato. Confronta la spesa totale con il numero di immagini che approvi così che il tuo budget rifletta risultati effettivamente utilizzabili.
## SEO Metadata
Meta title: Guida all’API FLUX 3 Image: Generazione, Editing e CometAPI
Meta description: Usa FLUX 3 Image su CometAPI per generazione ed editing. Scopri parametri immagine, gestione job asincroni, esempi di prompt e prezzi a partire da $0.0384 per richiesta.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, editing di immagini FLUX 3, prezzi FLUX 3, generazione con immagini di riferimento, migrazione FLUX.2
URL slug: flux-3-image-api-guide
Confronta sorgente e risultato nelle aree che dovrebbero rimanere invariate.
Authentication
Chiave API CometAPI per le richieste al gateway
Segui le intestazioni di autenticazione nell’esempio CometAPI; conserva la chiave sul server.
Result handling
Generazione asincrona: invia un job, traccia il suo task ID e recupera l’immagine finita.
Usa il template Python sotto quando la route del tuo account segue il contratto di task CometAPI per FLUX.
Pricing
Prezzi CometAPI a partire da $0.0384 per richiesta (9 novembre 2026).
Usa la sezione prezzi sotto per un budget illustrativo; verifica la configurazione selezionata.
Extra fields
Gli schemi nativo e gateway differiscono tra generazioni del modello
FLUX 3 Image nativo accetta width e height. Non riutilizzare seed o input_image di un modello più vecchio; usa images per gli input di riferimento nativi e segui lo schema del gateway su CometAPI.
