Guida all'integrazione GloopAPI
Fatturazione
Comprendi prenotazione, addebito e storage dei file.
Catalogo dei modelli, riepiloghi pubblici dei prezzi e contabilità effettiva delle chiamate sono informazioni distinte. Prima di un'operazione a pagamento, l'applicazione deve verificare modello o strumento, input e budget; un saldo sufficiente non garantisce i permessi di chiamata.
Prenotazione e addebito definitivo
All'accettazione della richiesta può essere prenotato un importo stimato. Una volta ricevuto l'utilizzo autorevole, l'addebito viene calcolato ai prezzi congelati, addebitando o restituendo la differenza. Il preventivo video basato sull'utilizzo è una stima, non una garanzia di spesa massima. La prenotazione massima degli strumenti è calcolata in base ai limiti degli input e alle regole congelate; il limite di costo viene controllato alla creazione.
status=succeeded descrive l'esito dell'esecuzione; billing.status=reserved indica ancora un costo da confermare. Un importo finale vuoto non equivale a zero. Invii al servizio dall'esito sconosciuto o dati di utilizzo in conflitto mantengono la prenotazione in attesa di verifica. Il rimborso di un errore confermato dipende dall'interfaccia e dalle prove di utilizzo; non si può garantire che tutti gli errori siano gratuiti.
Per il testo sincrono, consulta il consumo finale nei registri di utilizzo della piattaforma; per le attività asincrone, consulta lo stato contabile dell'attività. Non provare a chiudere la contabilità di una vecchia attività generando nuovamente.
Funzionalità di prezzo degli strumenti
pricing.mode distingue flat, prezzo costante per chiamata, input, precalcolo in base agli input, e usage, calcolo in base all'utilizzo finale. schema_version indica soltanto il formato della regola. amount in flat rappresenta il prezzo costante completo, compreso zero; input/usage non forniscono un importo costante fuorviante.
pricing.quote_required determina se una nuova chiamata richiede un preventivo; requires_usage indica se l'addebito finale richiede dati di utilizzo autorevoli, inclusi i vincoli contabili della piattaforma. Anche con prezzo di vendita flat possono essere necessari preventivo e utilizzo finale: decidi in base a questi due campi. Con requires_usage=true devi inviare max_cost_usd sufficiente a coprire maximum_usd, quindi attendere l'utilizzo autorevole dopo il successo prima dell'addebito definitivo. Le regole input senza utilizzo finale possono essere addebitate all'importo degli input dopo il preventivo, senza attendere i dati del servizio.
metered_pricing limita soltanto nuove chiamate che richiedono l'utilizzo finale; non limita regole costanti o basate sull'input che non lo richiedono, né blocca la consultazione delle esecuzioni accettate, la ripetizione idempotente della richiesta originale o il recupero della contabilità congelata. Il preventivo vincola Key, versione dello strumento, input normalizzati e configurazione di prezzi e fonte. Anche per strumenti a prezzo costante, ogni quote_id fornito viene verificato. La fascia minima mostrata nel catalogo non indica che lo strumento sia gratuito.
Conservazione dei file e spazio
I normali file API archiviati scadono secondo i giorni di conservazione del deployment. Immagini e video persistenti sono conservati a lungo tramite protezione dei riferimenti; expires_at=0 indica nessuna scadenza programmata. Occupazione dello storage e costo di generazione sono calcolati separatamente; prima di ready il download non è garantito.
Eliminare un'attività persistente svuota i risultati e rimuove i riferimenti eliminabili; i file non condivisi vengono ripuliti in background. Riferimenti condivisi, registri contabili e di idempotenza restano conservati. Eliminare un file o non riuscire a salvarlo non rimborsa automaticamente i costi di generazione già sostenuti. Un nuovo tentativo di salvataggio richiede spazio disponibile e riusa il risultato originale senza rigenerarlo.
Quota insufficiente
In caso di 403, 402 o errori di quota, controlla prima i limiti dell'account e della Key. L'autenticazione persistente permette a una Key valida con quota esaurita di leggere la cronologia, ma le nuove attività richiedono comunque budget. Per completare la contabilità di un'attività, continua a consultare il record originale; non reinviarla cambiando Key o chiave di richiesta. Vedi Autenticazione e Attività asincrone e idempotenza.