guides

2026-10-21: 8 lamentele sulle API che abbiamo sentito oggi

PoYo Team
10 min read
Share:

Lamentele pubblicate apertamente su X da sviluppatori di lingua inglese tra il 19 e il 21 ottobre 2026, riassunte qui con i link ai post originali. Ogni risposta usa solo ciò che il sito pubblico e la documentazione di PoYo dicono oggi, e rimanda alla pagina da cui proviene. Dove la documentazione non copre un punto, lo diciamo.


Q1. Uno strumento di cui mi fidavo ha esposto la mia chiave API, e mi sono svegliato con un addebito. Come limito il danno la prossima volta?

Di che cosa si lamentano gli sviluppatori: La violazione di OpenCode Console è stata il tema API più grande degli ultimi due giorni. OpenCode dice che le chiavi dei fornitori salvate da circa l’1,4 % degli utenti di Console possono essere state esposte. Alcuni sviluppatori hanno segnalato addebiti non autorizzati su OpenAI, Anthropic e Google, in un caso di 1.700 $. Il consiglio si è ripetuto: dare a ogni strumento una chiave propria con un tetto di spesa, e ricordare che cancellare una chiave dentro uno strumento di terzi non la revoca. Un altro sviluppatore ha pubblicato un addebito di 420 $ da una chiave del 2024 dimenticata.

Come risponde PoYo: La documentazione elenca tre controlli che si possono mettere su una chiave PoYo:

  • Tetti di utilizzo per chiave (orari, giornalieri e totali) e una whitelist di IP, così solo gli IP dei server che approvate possono usare la chiave. Entrambi sono sulla pagina delle chiavi API e sono spiegati in Per iniziare.
  • Blocco per utente finale. L’applicazione invia un header X-End-User-ID a ogni richiesta. Poi si può bloccare un chiamante abusivo su una chiave senza ruotarla né disattivarla. Si può anche rendere l’header obbligatorio per ogni richiesta di quella chiave. Vedi Identificazione dell’utente finale.
  • Le chiavi restano sul server. La documentazione dice di non mettere le chiavi nel codice del browser, nelle app mobili o nei repository pubblici.

La documentazione pubblica non promette rimborsi per l’uso fatto con una chiave esposta. Se ritenete che una chiave PoYo sia stata usata in modo improprio, revocatela e contattate il supporto ([email protected]).


Q2. Ho prepagato crediti API e, un anno dopo, non c’erano più.

Di che cosa si lamentano gli sviluppatori: Un post molto condiviso sosteneva che la scadenza dopo 12 mesi dei crediti prepagati di Anthropic e OpenAI non abbia una ragione tecnica, perché si tiene un saldo in dollari, non tempo GPU riservato. L’autore ha scritto di aver perso personalmente circa 50 dollari per la scadenza.

Come risponde PoYo: La home di PoYo lo dice in modo diretto: prezzi a crediti, niente abbonamenti, acquisti una tantum e crediti che non scadono. Il saldo corrente si legge in qualsiasi momento dall’endpoint del saldo utente (GET /api/user/balance), che restituisce credits_amount in tempo reale.


Q3. Gemini 3.8 Flash restituisce da giorni un 503 «nessuna capacità». Che cosa faccio quando un upstream si blocca?

Di che cosa si lamentano gli sviluppatori: Uno sviluppatore ha scritto che il piano gratuito di gemini-3.8-flash restituiva 503 da 2,5 giorni. Un altro ha visto in Antigravity risposte oltre i 60 secondi o errori 503 di capacità. Sul lato degli strumenti di codice, un’analisi ha contato 42,7 ore di incidenti Codex ancora aperti in due settimane e ha sostenuto che i disservizi, non il gusto, spiegano perché molte persone pagano due strumenti di codice.

Come risponde PoYo: Ecco che cosa la documentazione sostiene, e che cosa non sostiene:

  • Una chiave, molti modelli. Gemini 3.8 Flash, Gemini 3.7 Flash e i modelli Claude, GPT e DeepSeek girano sulla stessa chiave PoYo. Se un modello va male, si cambia il valore di model. Tutti i modelli sono in llms.txt.
  • Codici di errore separati. La pagina dei codici di errore distingue 502 upstream_error da 503 service_error («il server è occupato») e consiglia di riprovare entrambi con backoff esponenziale.
  • Che cosa non affermiamo. La documentazione non descrive un failover automatico tra fornitori. Se volete un fallback, costruitelo nel client. Per iniziare dice anche, in modo diretto, che «la stabilità complessiva di PoYo può essere leggermente inferiore a quella dei fornitori ufficiali». Preferiamo dirlo prima.

Q4. Il mio 429 non era davvero un limite di frequenza. Perché i fornitori riusano lo stesso errore per cose diverse?

Di che cosa si lamentano gli sviluppatori: Uno sviluppatore ha spiegato che il 429 incontrato era in realtà un tetto di livello sul contesto lungo, non un limite di frequenza, e che gli è servita circa un’ora nei pannelli per capirlo. Un tutorial collegato sugli errori di quota di Gemini (16 ottobre) percorre un unico 429 RESOURCE_EXHAUSTED che può significare «nessuna quota per questo modello», «limite al minuto» o «limite al giorno». Ogni caso chiede un intervento diverso.

Come risponde PoYo: La nostra pagina dei codici di errore dà a ogni stato un solo significato:

Codiceerror.typeChe cosa fare
402insufficient_credits_errorRicaricare. Riprovare non serve.
429rate_limit_errorAttendere e riprovare, oppure mettere le richieste in coda.
502upstream_errorRiprovare con backoff.
503service_errorRiprovare con backoff.

La stessa pagina chiede di tenere d’occhio il saldo dei crediti per non incontrare un 402 nel mezzo di un lavoro critico. Il modo per controllarlo è l’endpoint del saldo.


Q5. I lavori in batch incontrano limiti di frequenza a metà strada.

Di che cosa si lamentano gli sviluppatori: Uno sviluppatore che costruisce un agente di lead generation con n8n ha detto che i limiti di frequenza dell’API durante le esecuzioni in batch erano il problema più grande, e ha chiesto come gli altri gestiscono backoff e deduplicazione.

Come risponde PoYo: Per iniziare pubblica il limite predefinito: fino a 20 nuove richieste di generazione ogni 10 secondi, per account, il che «di solito consente più di 100 attività in esecuzione insieme». Le richieste oltre il limite ricevono un HTTP 429 e non entrano in coda. Vanno quindi distanziate, invece di inviarle tutte insieme. Se i 429 sono continui, la documentazione dice che si può chiedere al supporto un limite più alto; le approvazioni sono prudenti.

La generazione è asincrona: si invia un’attività, si riceve un task_id e poi si interroga lo stato o si riceve un callback (panoramica dell’API). Per i batch grandi, la documentazione consiglia webhook firmati (HMAC-SHA256) invece di un polling frequente. Sulla deduplicazione la regola è una: trattate ogni nuovo invio come un lavoro che può essere addebitato di nuovo, e controllate se la richiesta originale ha già creato un’attività prima di riprovare.


Q6. Le API video di IA costano importi molto diversi, e continuo a pagare clip che non posso usare.

Di che cosa si lamentano gli sviluppatori: Un confronto di prezzi ha trovato prezzi di generazione video che variano di oltre 3 volte per lo stesso modello tra i fornitori. Un altro sviluppatore ha scritto che Higgsfield resta troppo caro anche con Seedance 2.5 e ha chiesto opzioni più economiche. Un terzo ha detto di aver speso circa 12 dollari su 40 di crediti nel generatore video di un’app senza ottenere una clip utilizzabile di 15 secondi.

Come risponde PoYo: Tutti i modelli video sono sulla pagina API video IA e usano lo stesso flusso asincrono di invio e stato. Ogni modello pubblica prezzi al secondo. Per esempio, Seedance 2.5 indica 480p a 0,140 $/s e 1080p a 0,570 $/s senza input video, con tariffe più basse quando la richiesta include un video di riferimento. La pagina dei prezzi mette il prezzo PoYo accanto al prezzo ufficiale, quando questo è indicato.

Sui fallimenti: sia llms.txt sia le pagine dei modelli dicono che le attività non riuscite non vengono addebitate. Per chiarezza, un’attività che termina ma restituisce una clip che non vi soddisfa conta come output riuscito e viene addebitata. I prompt si possono provare nel Playground di ogni pagina di modello prima di chiamare l’API.


Q7. L’API economica che uso sta davvero servendo il modello che dichiara?

Di che cosa si lamentano gli sviluppatori: Uno sviluppatore ha scritto che OpenRouter ha iniziato a inviare le richieste GLM a un endpoint quantizzato in FP4, e che il progetto si è rotto prima che capisse che cosa era cambiato. Un altro post ha descritto relay di API che si presentano come «fornitura diretta ufficiale al 100 %», venduti con forti sconti ma lenti, e come riconoscere un upstream che non è quello dichiarato.

Come risponde PoYo: Sulle pagine pubbliche si può verificare questo:

  • Varianti official con nome esplicito. Alcuni modelli sono offerti come varianti «official» dal nome chiaro, per esempio Sora 2 Official e Veo 3.1 Official. Sono elencate a parte dalle altre varianti dello stesso modello, come mostra llms.txt.
  • Schema e prezzi pubblici. Ogni modello pubblica lo schema di input e il prezzo correnti nel proprio llms.txt.
  • Cronologia delle attività. La pagina della cronologia mostra modello, parametri di input, stato e risultato o errore di ogni attività (vedi Per iniziare).

La documentazione pubblica non descrive come ogni richiesta viene instradata a monte. Qui non facciamo quindi affermazioni sul routing.


Q8. La fattura dei token del mio agente è fuori controllo.

Di che cosa si lamentano gli sviluppatori: Uno sviluppatore ha confrontato un mese di costi di un agente di ricerca: 220 $ con Opus 5.5 contro 4,80 $ con DeepSeek. Un altro ha sostenuto che, se Gemini 4 Argon eguaglia Opus a un costo minore, «la fedeltà al marchio non salverà la vostra fattura API».

Come risponde PoYo: Tutti questi modelli girano su una sola chiave. Spostare un carico su un modello più economico significa cambiare il campo model, non ricominciare un’integrazione. Prezzi indicati ora:

  • Claude Opus 5.5: 3,20 $ in input / 16,00 $ in output per 1 milione di token. La pagina del modello lo descrive come il 20 % sotto le tariffe ufficiali standard.
  • Gemini 4 Argon: 1,60 $ / 8,00 $ per 1 milione di token (20 % sotto il prezzo ufficiale).
  • DeepSeek V4.1 Flash: 0,30 $ / 1,20 $ per 1 milione di token.

Controllate la pagina dei prezzi prima di impegnare un carico. I prezzi cambiano, e il llms.txt di ogni modello ha sempre le cifre correnti.


Mappa rapida

LamentelaDove PoYo lo documenta
Chiavi esposte / addebiti imprevistiPagina delle chiavi API · Per iniziare · X-End-User-ID
Crediti che scadonoHome: i crediti non scadono · API del saldo
503 a monte / disserviziCodici di errore · elenco modelli in llms.txt
Che cosa significa un 429Codici di errore
Limiti di frequenza nei batchPer iniziare: limiti di frequenza · Webhook
Prezzi del video / clip inutilizzabiliAPI video IA · Prezzi
Fiducia nel rivenditoreCronologia delle attività · llms.txt di ogni modello
Fatture dei tokenPrezzi · pagine dei modelli
Share: