flux-pro-1.0-depth API

Specifiche tecniche di flux-pro-1-0-depth

Che cos'è flux-pro-1-0-depth?

flux-pro-1-0-depth è l'identificatore di piattaforma di CometAPI per il modello FLUX Pro 1.0 Depth di Black Forest Labs, un modello di generazione e modifica di immagini consapevole della profondità progettato per preservare la struttura 3D di una scena durante l'applicazione di trasformazioni basate su prompt. Invece di trattare un'immagine come semplice contenuto di pixel piatti, utilizza un controllo guidato dalla profondità affinché le modifiche rispettino meglio la prospettiva, la collocazione degli oggetti e la scala relativa.

Ciò rende il modello particolarmente utile quando si desidera ristilizzare o modificare un'immagine esistente senza perderne la coerenza spaziale. Nelle descrizioni pubbliche di FLUX.1 Depth, Black Forest Labs e la documentazione dell'ecosistema enfatizzano casi d'uso quali scene architettoniche, visualizzazione di prodotto, trasferimento di stile che preserva la struttura ed editing in cui è importante mantenere una geometria realistica.

Vale anche la pena notare che l'endpoint originale di Black Forest Labs con questo nome di modello è stato deprecato a decorrere dal 31 ottobre 2025. Ciò non cambia il codice del modello di CometAPI da utilizzare qui, ma è un contesto rilevante per gli sviluppatori che valutano la compatibilità a lungo termine e la pianificazione della migrazione.

Caratteristiche principali di flux-pro-1-0-depth

• Controllo consapevole della profondità: il modello è progettato per utilizzare la guida di profondità, così le modifiche generate si allineano in modo più naturale con la geometria e la prospettiva della scena.
• Preservazione delle relazioni spaziali: è progettato per mantenere le relazioni 3D tra gli oggetti, aiutando a mantenere credibili le composizioni dopo la trasformazione.
• Trasformazione delle immagini con preservazione della struttura: i workflow di profondità FLUX sono descritti come utili per il retexturing, il restyling controllato e la conversione di input strutturati in risultati visivi più ricchi mantenendo il layout.
• Ottima aderenza ai workflow di visualizzazione: la documentazione pubblica del modello evidenzia come punti di forza la visualizzazione architettonica, il posizionamento di prodotto e la composizione accurata delle scene.
• Maggior controllo creativo rispetto alla semplice generazione basata solo su prompt: poiché il modello può seguire la struttura dell'immagine oltre alle istruzioni testuali, è più adatto a modifiche in cui contano coerenza e controllabilità. Si tratta di un'inferenza basata sul design guidato dalla profondità documentato del modello e sui casi d'uso dichiarati.
• Integrazione professionale nell'ecosistema FLUX: fa parte del toolset FLUX Pro per workflow avanzati di generazione ed editing di immagini.
• Stato di deprecazione dell'endpoint a monte: gli sviluppatori dovrebbero essere consapevoli che Black Forest Labs indica l'endpoint originale flux-pro-1.0-depth come deprecato a partire dal 31 ottobre 2025.

Come accedere e integrare flux-pro-1-0-depth

Passaggio 1: Registrati per ottenere una chiave API

Per iniziare, registrati su CometAPI e genera la tua chiave API dalla dashboard. Userai questa chiave per autenticare tutte le richieste all'API flux-pro-1-0-depth.

Passaggio 2: Invia richieste all'API flux-pro-1-0-depth

Utilizza l'endpoint compatibile con Flux di CometAPI su POST /flux/v1/{model}.

curl https://api.cometapi.com/flux/v1/flux-pro-1-0-depth \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "A breathtaking landscape painting with golden hour lighting",
    "width": 1024,
    "height": 768,
    "steps": 20,
    "prompt_upsampling": true
  }'

Passaggio 3: Recupera e verifica i risultati

L'API restituisce un ID attività. Effettua il polling su GET /flux/v1/get_result?id={task_id} per verificare lo stato della generazione e recuperare l'immagine di output al termine.