L’API Krea 3 è in accesso anticipato. Possono chiamarla solo i workspace che partecipano alla beta di Krea 3. Per richiedere l’accesso, contatta sales@krea.ai.
Endpoint
L’endpoint segue il ciclo di vita del job standard: restituisce un
job_id ed esegui il polling di GET /jobs/{job_id} (oppure usi un webhook) finché il job non è completato. L’immagine di output si trova in result.urls[0].
Quickstart: la tua prima modifica di immagine
Tutte le richieste richiedono un Bearer token. Vedi API Keys & Billing se non ne hai ancora uno.1
Carica un riferimento
POST /assets con la tua immagine di input. La risposta restituisce image_url. Puoi anche passare direttamente in image_urls l’URL di un’immagine esterna o una data URI base64.2
Crea una modifica
POST /generate/image/krea/krea-3 con il tuo prompt e il riferimento. Salva il job_id dalla risposta.3
Ottieni il risultato
Esegui il polling di
GET /jobs/{job_id} finché status non è completed. L’output si trova in result.urls[0].Parametri
Con
width e height, l’output viene arrotondato all’aspect ratio supportato più vicino e a un canvas 1k o 2k. Le dimensioni esatte in pixel non sono garantite.Riutilizzare un seed non garantisce risultati identici, perché la fase di espansione del prompt può variare da un’esecuzione all’altra.Modalità di ragionamento
Prima di generare, Krea 3 interpreta il tuo prompt.thinking_mode stabilisce quanta pianificazione esegue.
Se ometti
thinking_mode, l’API usa fast. Entrambe le modalità supportano regional_edit.
Modifiche regionali
Conregional_edit: true, Krea 3 rigenera solo le parti dell’immagine che devono cambiare. Tutto il resto rimane esattamente com’era, quindi puoi modificare la stessa immagine più e più volte senza perdita di qualità.
Usalo per le modifiche locali, in cui il resto dell’immagine deve restare identico al pixel: ricolorare o sostituire un oggetto, aggiungere o rimuovere un elemento, correggere un dettaglio o cambiare il testo di un cartello. È il modo sicuro per concatenare modifiche sull’ultimo output.
Non usarlo per le modifiche globali che devono rigenerare l’intera immagine: cambiare stile, illuminazione, stagione o momento della giornata, reinquadrare o combinare più immagini in una nuova scena. Le modifiche normali rigenerano l’intera immagine, quindi possono accumularsi artefatti se continui a modificare l’ultimo output.
Le modifiche regionali richiedono almeno un’immagine in image_urls.
Scrivere i prompt
Krea 3 è un editor che segue le istruzioni. Scrivi la modifica in linguaggio naturale:- Inizia dalla modifica. Aggiungi solo i dettagli che aiutano a eseguirla.
- Chiudi con una frase di conservazione quando il resto dell’immagine deve restare invariato. Non elencare tutto ciò che deve restare uguale.
- Quando il prompt usa più di un’immagine, fai riferimento a ciascuna in base a ciò che mostra. Ad esempio: “Metti la sneaker della seconda immagine alla persona nella prima immagine.”
Immagini di riferimento
- Krea 3 usa ogni riferimento alla risoluzione con cui è stato caricato. Un riferimento più grande di 4 MP viene ridimensionato a 4 MP.
- Circa 1 MP è sufficiente per la maggior parte delle modifiche. Non fare l’upscaling di un riferimento prima di inviarlo.
- Quando contano i dettagli fini (testo piccolo, loghi, tessuti, volti in un campo largo), invia la versione dell’immagine con la risoluzione più alta che hai.
- Con cinque o più riferimenti in una richiesta, ogni riferimento viene ridimensionato a un massimo di 1536 px sul lato più lungo. Per riferimenti con tutti i dettagli, inviane quattro o meno.
Zero Data Retention
Krea 3 supporta Zero Data Retention per i workspace enterprise. Invia l’headerX-Api-Zero-Data-Retention: 1. Con Zero Data Retention:
- Ogni immagine in
image_urlsdeve essere una data URI base64. thinking_modepuò esserefastohigh.- Una richiesta può usare al massimo 4 immagini di riferimento.
Prezzi
Il prezzo per immagine dipende dalla risoluzione di output, dalla modalità di ragionamento e dalle immagini di riferimento.Risorse correlate
Ciclo di vita del job
Stati dei job, polling e risultati.
Webhook
Ricevi una notifica al completamento di un job invece di fare polling.