Saldo API e rimborsi

L’API di PopNow ha un saldo proprio in USD. Le chiamate con chiave API, l’MCP per sviluppatori e le esecuzioni in Playground sulle pagine API lo consumano. Lo stesso modello con le stesse impostazioni costa uguale nell’API e su popnow.ai.

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 proprie. Nel saldo entrano solo i fondi API aggiunti in Fatturazione API, e vengono spesi solo dall’API.
• Preventivo prima dell’esecuzione. jobs/quote restituisce expectedChargeUsd e maxChargeUsd come stringhe decimali in USD senza avviare un’attività.
• Controlla 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.

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.

Cosa consuma il saldo API

Se una richiesta API non può coprire la trattenuta, aggiungi fondi API in Fatturazione API.

Come viene calcolato il costo di 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. Playground sulle pagine API usa lo stesso saldo API in USD.

Richiedi l’importo esatto prima di avviare la generazione:

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.

Devo chiedere il rilascio di una trattenuta?

No. Le attività fallite e scadute rilasciano automaticamente le trattenute. 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.

Correlati