Introduzione
Krea 2 Medium è il livello per tutti i giorni della linea Krea 2: non punta al dettaglio dei materiali da finitura di Large e non insegue la velocità di Medium Turbo. Mantiene l’aspetto fotografico in luce naturale della linea, con prezzo e ritmo pensati per i volumi.
Krea 2 Medium è il livello per i volumi della linea Krea 2: un unico endpoint testo in immagine, prompt fino a 5.000 caratteri, cinque formati e la scelta tra PNG e JPEG. Pensato per le immagini che ti servono in quantità.
Caratteristiche principali
Una direzione fotografica per il lavoro in volume
Krea 2 Medium è adatto a generare più immagini candidate mentre il team sta ancora scegliendo composizione e direzione visiva. Confronta le candidate con un unico brief creativo invece di mescolare idee scollegate nello stesso batch.
Conserva il brief approvato per la fase successiva
Quando una direzione supera la revisione, tieni insieme la formulazione e l’immagine scelta. Questa traccia è più utile a un flusso di finitura di una vaga richiesta di ricreare lo stesso look più avanti.
Usa il modello per un’immagine nuova, non per modificare una fonte
Questa modalità parte da una direzione scritta. Quando un’immagine esistente deve mantenere identità o impaginazione, scegli una modalità di modifica invece di chiedere a una generazione solo testuale di avvicinarsi alla fonte.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Apri con il soggetto, poi la composizione, la luce e la materia; il resto lascialo non detto invece di imbottirlo di aggettivi. almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | Quadrato per impostazione predefinita, con le cinque forme che le collocazioni chiedono più spesso, dal 16:9 orizzontale al 9:16 verticale. |
output_format | No | png per impostazione predefinita, oppure jpeg. |
Prezzi
$0.03 / immagine
Casi d’uso
Partire da un brief scritto
Usa questo endpoint quando un solo brief deve produrre molte immagini candidate: prompt fino a 5.000 caratteri, cinque formati e PNG come predefinito, così le immagini scelte passano subito al ritocco. Non c’è input di immagine, quindi tutta la direzione deve stare nelle parole.
Anteprime interne e bozze per il pitch
Abbastanza qualità per presentare un concept senza dedicare il tempo di un livello di finitura a un’immagine che poi verrà sostituita. La formulazione approvata passa invariata su Krea 2 Large.
Serie editoriali e ritratti
Ritratti in luce ambiente, interni e immagini di styling, cinquanta alla volta tramite un unico endpoint. Il PNG predefinito lo rende pratico: le immagini scelte vanno subito al ritocco invece che a una nuova esportazione, e nulla si perde in una compressione con perdita prima che qualcuno abbia scelto.
Contenuti per social e feed
Medium offre 1:1, 4:3, 3:4, 16:9 e 9:16 — nessun formato panoramico né striscia anamorfica —, quindi scegli prima il formato del posizionamento e scrivi il prompt per quello. Scegli JPEG quando le immagini vanno dritte in un feed e PNG quando verranno ritoccate.
Consigli avanzati
Descrivi la luce, non gli aggettivi
Descrivi da dove arriva la luce e su cosa cade — una lampada sul comodino, una finestra al tramonto, una lampadina nuda — e indica obiettivo e pellicola. Una luce precisa fa di più per l’aspetto fotografico di questa linea di parole come «mozzafiato» o «iperrealistico».
Tieni il prompt insieme all’immagine buona
Senza seed, un’immagine riuscita non si può rigenerare. Salva il prompt accanto al file e, quando una formulazione supera la revisione, portala invariata su Krea 2 Large per la finitura.
Adatta l’esempio incluso
Parti dall’esempio pubblicato con aspect_ratio: 3:4 e output_format: png. Sostituisci soggetto e direzione creativa mantenendo intatto il contratto di input di questa modalità.
Available-light photograph seen through a half-open hotel room door, an adult woman sitting on the edge of a made bed wearing only an oversized cream knit sweater, bare legs crossed, absorbed in her phone, one warm bedside lamp, deep falling shadows, quiet and unposed, muted amber palette, 50mm, fine film grain.
Il prompt dietro l’immagine di riferimento di questo endpoint: qui gira invariato, anche se l’immagine mostrata è stata prodotta sul livello Turbo della stessa linea come riferimento di stile.
Controlla il risultato prima di iterare
Tre campi, non di più: prompt, aspect_ratio e output_format. Non c’è un seed, quindi non si può fissare nulla e un’immagine da tenere va salvata con il suo prompt. Questo endpoint non accetta immagini in ingresso — né immagine in immagine né immagini di riferimento — e non ha un controllo della creatività. Per i riferimenti di stile usa Krea 2 Medium Turbo o Krea 2 Large; per il massimo dettaglio, Krea 2 Large. Medium non ha nemmeno formati panoramici o anamorfici.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "krea/2-medium/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
