Risoluzione dei problemi di Coloring Book Engine

La generazione non parte

• API Key Required / pulsante Send disattivato — non è configurata nessuna chiave AI. Schermata Projects → Connect Your AI.
• Prompt is required for generation — la pagina non ha un prompt; compilalo nel Plan.
• Run Rest è disattivato — non c’è nulla da riempire: ogni pagina è completata o già in coda.
• Prerequisites Not Ready — a una fase manca il suo input (ad es. la coloritura richiede sketch processati). Il messaggio indica quale fase completare per prima.

La generazione si ferma o fallisce

• Generation Stopped (dopo 2 fallimenti consecutivi) — la coda si mette in pausa per proteggere i tuoi crediti. Le cause abituali sono i limiti di velocità del provider o un’interruzione temporanea; attendi un minuto e premi Run Rest per riprendere da dove si era fermata.
• Errori 429 / rate-limit — l’app regola già la velocità delle richieste, ma altri strumenti che condividono la tua chiave API consumano lo stesso limite. Metti in pausa l’altro strumento o aspetta.
• Organization Verification Required — gpt-image-2 richiede una verifica una tantum sul tuo account OpenAI; nel frattempo la generazione continua automaticamente su dall-e-3. Riprova le pagine interessate dopo la verifica (gli style anchor richiedono un modello capace di leggere i riferimenti).
• Una singola pagina continua a fallire — riprovala individualmente; se persiste, riformula leggermente il prompt di quella pagina (occasionalmente un prompt specifico fa scattare il filtro dei contenuti di un provider).

Il risultato sembra sbagliato

• Il personaggio appare diverso in alcune pagine — assicurati che i prompt di quelle pagine menzionino davvero il personaggio ({Nome}), e che le pagine non siano state generate durante un fallback su dall-e-3 (in tal caso la card mostra un avviso).
• Lo stile va alla deriva nel libro — imposta uno style anchor nella toolbar di Sketch (richiede un’immagine di stile nel tuo Image Pool).
• La maschera riversa colore nello sfondo — apri quella pagina nel Masking Editor e riempi la perdita col secchiello; di solito bastano due clic.
• Una card video mostra “Missing: …” — quella pagina ha saltato un passo di Assets; il messaggio indica quale.

Ancora bloccato?

Contatta il supporto — includi il testo esatto del messaggio e in quale fase/tab ti trovavi, e di solito riusciamo a individuare il problema immediatamente.