Saldo API e rimborsi

L’API di PopNow ha un saldo proprio in USD, separato dai crediti del sito. Le chiamate con chiave API, le connessioni MCP con chiave API e Playground consumano USD API. MCP collegato tramite OAuth continua a usare i crediti del sito. API e sito applicano lo stesso prezzo allo stesso modello con le stesse impostazioni; i saldi non si possono trasferire né usare l’uno al posto dell’altro.

Questa pagina spiega ricariche API, prezzi e rilascio delle trattenute. Per trattenute, preventivi e tetti delle singole attività, vedi Fatturazione API.

Il saldo API in un minuto

• Parte da $0. Aggiungi fondi API in Fatturazione API prima di eseguire richieste a pagamento, compresi i test in Playground.
• Ricariche separate. Pacchetti di crediti, crediti bonus e premi del sito non pagano le chiamate API. I fondi API non pagano le generazioni sul sito né le chiamate MCP via OAuth.
• Preventivo prima dell’esecuzione. jobs/quote restituisce expectedChargeUsd e maxChargeUsd come stringhe decimali in USD senza avviare un’attività.
• Leggi l’importo definitivo. Il costUsd di un’attività è l’addebito finale in USD quando settled è true. Le attività fallite o scadute rilasciano automaticamente le trattenute, salvo eventuali addebiti per rifiuto di contenuti previsti dal singolo modello.

Da dove vengono i fondi API

Gestisci ricariche API e pagamenti in Fatturazione API, usando le opzioni di pagamento attualmente abilitate. Crea e gestisci le chiavi separatamente in Chiavi API.

Bonus dei pacchetti di crediti, premi per inviti e altri accrediti del sito non aumentano il saldo API. Tagli dei pacchetti, periodi di rimborso e regole di scadenza del sito non sono condizioni delle ricariche API.

Quale saldo viene usato

Le credenziali e l’interfaccia determinano quale saldo paga:

Ricaricare un saldo non ricarica l’altro. Se una richiesta API non può coprire la trattenuta, aggiungi fondi API anziché acquistare crediti del sito.

Come si prezza una generazione

Ogni modello ha un proprio listino, impostato per opzione: per immagine, per secondo di video o audio, per canzone o per 1.000 caratteri di sintesi vocale. Il prezzo dipende da ciò che chiedi: risoluzione, durata, livello di qualità e, per alcuni modelli, quanti file di riferimento invii.

Alcuni esempi di prezzi API in USD:

Modelli rimanda alle pagine di riferimento dei modelli. Usa il preventivo aggiornato per le tue impostazioni e mantieni la precisione decimale in USD (fino a nove cifre decimali); non arrotondare gli addebiti API ai crediti interi. Playground sulle pagine API usa lo stesso saldo API in USD.

Chiedi l’importo esatto prima di avviare qualsiasi cosa:

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax/h3/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5}}'

import os, requests

quote = requests.post(
    "https://api.popnow.ai/api/v1/jobs/quote",
    headers={"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"},
    json={
        "model": "minimax/h3/image-to-video",
        "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5},
    },
    timeout=30,
).json()["data"]
print(quote["maxChargeUsd"], "USD at most,", quote["expectedChargeUsd"], "USD estimated")

const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'minimax/h3/image-to-video',
    input: { image_url: 'https://media.popnow.ai/movie/lighthouse.webp', prompt: 'The waves roll in slowly', duration_seconds: 5 },
  }),
});
const { data } = await res.json();
console.log(`${data.maxChargeUsd} USD at most, ${data.expectedChargeUsd} USD estimated`);

Cosa succede quando un’attività fallisce

Quando un’attività viene accettata, il suo prezzo massimo possibile in USD viene messo da parte sul saldo API come trattenuta. Quando termina:

Il rilascio di una trattenuta ripristina i fondi API disponibili; non è un rimborso di un pagamento sul conto bancario o sulla carta. Leggi costUsd con settled nel record dell’attività per l’importo finale in USD. Vedi Fatturazione API.

Rimborsi dei pagamenti API

Per domande su una ricarica API o un rimborso, apri Fatturazione API o contatta l’assistenza. Includi il riferimento del pagamento o l’ID dell’attività, mai la chiave API.

Errori che potresti incontrare

Tutti i codici sono elencati in Errori.

Le chiamate API costano più che generare sul sito?

No. Lo stesso modello con le stesse impostazioni ha lo stesso prezzo. Le chiamate API sono addebitate in USD sul saldo API; le generazioni sul sito e MCP via OAuth usano i crediti del sito. I saldi restano separati.

Devo chiedere il rilascio di una trattenuta?

No. Le attività fallite e scadute rilasciano automaticamente le trattenute, salvo eventuali addebiti per rifiuto di contenuti previsti dal singolo modello. Controlla il costUsd definitivo dell’attività per l’importo finale in USD.

Posso ottenere un rimborso su una ricarica API?

Per sapere se un pagamento API è rimborsabile e ricevere assistenza, apri Fatturazione API o contatta l’assistenza.

Ai fondi API si applica la scadenza dei crediti del sito?

Le regole di scadenza dei pacchetti di crediti e dei premi del sito non definiscono le condizioni API. Consulta Fatturazione API o chiedi all’assistenza informazioni sui tuoi fondi API.

Posso finanziare l’API con i crediti del sito?

No. Aggiungi fondi API tramite Fatturazione API. I crediti del sito non finanziano l’API, i fondi API non pagano le generazioni sul sito e i saldi non si possono trasferire.

Correlati