Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
aspect_ratio | No | La forma dell'inquadratura: larga, quadrata o verticale. 1:1 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 · 2:3 · 9:16 · Predefinito: 1:1 |
prompt | Sì | Describe the image to generate: subject, composition, style, and lighting. |
reference_image_urls | No | Immagini di persone, abiti o luoghi che il risultato deve mantenere. |
reference_strength | No | How strongly the reference images shape the result, from 0 to 1. At 1 the composition can carry over too; lower values mostly keep the palette and texture. ≥ 0 · ≤ 1 · Predefinito: 1 |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti per immagine | ≈ USD |
|---|---|---|
| Standard | 9 | 0,09 USD |
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Krea 2 Large in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model krea/2-large/text-to-image e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "krea/2-large/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Krea 2 Large
Quanto costa l’API di Krea 2 Large?
Krea 2 Large costa 9 crediti (0,09 USD) per immagine. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Krea 2 Large nell’API?
Inserisci krea/2-large/text-to-image per Crea immagine nel campo model di POST /jobs/createTask.
In che cosa Large si distingue da Krea 2 Medium e Medium Turbo?
Tutti e tre prendono un prompt e restituiscono un'immagine. Large è il più lento e ha il tetto più alto di dettaglio e materia. Medium Turbo è la fascia rapida e condivide con Large gli otto rapporti, 2.35:1 compreso, e i riferimenti di stile. Medium ha cinque rapporti e nessun ingresso per riferimenti, ma ti lascia scegliere png o jpeg.
Perché su questo endpoint non c'è il seed?
L'API di Krea ne ha uno, ma questo endpoint non lo espone, quindi qui non si può fissare nulla. Un fotogramma che vuoi tenere va tenuto: conserva il prompt insieme all'asset, perché una nuova esecuzione disegnerà qualcosa di diverso.
Posso passare un'immagine di riferimento?
Sì, fino a dieci, e il campo è opzionale. Con la reference_strength predefinita di 1 portano anche la loro composizione, oltre a palette, grana, materia e luce; abbassala per tenere soprattutto colore e texture: a 0,2 l’impaginazione segue in gran parte il prompt, anche se lo stile resta ben visibile. Contano tutte e dieci allo stesso modo, quindi due o tre angolazioni di un unico look rendono più di una pila di immagini quasi identiche.
Esiste un controllo di creatività o di aderenza?
No. L'interruttore della creatività di Krea è una categoria discreta a quattro livelli senza una corrispondenza autorevole con una scala numerica familiare, e un controllo che punta dalla parte sbagliata è peggio di nessun controllo. Viene usato il livello predefinito.
Quanto può essere lungo un prompt?
Fino a 5.000 caratteri. Spendili su pellicola, ottica, direzione della luce e materia; imbottire di aggettivi è il punto in cui una descrizione comincia a contraddirsi, su questa fascia.
Quali sono i limiti dell’API di Krea 2 Large?
Proporzioni: 1:1 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 +2; Immagini di riferimento: 10; Lunghezza del prompt (caratteri): 5,000. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Krea 2 Large senza scrivere codice?
Sì. Il Playground esegue Krea 2 Large con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli Krea
Krea 2 Medium Turbo accetta gli stessi prompt e riferimenti, molto più veloce ed economico, ed è il posto dove esplorare. Large è per il fotogramma finale.
- API di Krea 2 Turbo LoRAImmagini e restyling Krea 2 Turbo con le tue LoRADa 4 crediti per immagine
- API di Krea 2 LargeIl livello più dettagliato di Krea, per fotogrammi chiave cinematograficiDa 9 crediti per immagine
- API di Krea 2 MediumKrea per tutti i giorni, per una produzione costanteDa 5 crediti per immagine
- API di Krea 2 Medium TurboKrea veloce, guidato da fino a dieci riferimenti di stileDa 3 crediti per immagine

