Solde API et remboursements
Le solde API séparé en USD, les prix des modèles, les réservations libérées et l’aide pour les remboursements de paiements API.
L’API PopNow dispose de son propre solde en USD, séparé des crédits du site. Les appels avec clé API, les connexions MCP avec clé API et les exécutions du Playground dépensent des USD API. MCP connecté par OAuth utilise toujours les crédits du site. L’API et le site appliquent le même prix au même modèle avec les mêmes réglages ; les soldes ne peuvent être ni transférés ni utilisés l’un à la place de l’autre.
Cette page explique l’approvisionnement API, les prix et les réservations libérées. Pour les réservations, devis et plafonds d’une tâche, voir Facturation API.
Le solde API en une minute
- Initialement $0. Approvisionnez-le dans Facturation API avant toute requête payante, y compris les tests du Playground.
- Approvisionnement séparé. Les packs, bonus et récompenses en crédits du site ne paient pas les appels API. Les fonds API ne paient pas les générations du site ni les appels MCP par OAuth.
- Demandez un devis avant l’exécution.
jobs/quoterenvoieexpectedChargeUsdetmaxChargeUsdsous forme de chaînes décimales USD sans démarrer de tâche. - Lisez le montant définitif. Le
costUsdd’une tâche est son débit final en USD lorsquesettledvauttrue. Les tâches échouées ou expirées libèrent automatiquement leur réservation, sous réserve des frais de refus de contenu propres à certains modèles.
Approvisionner le solde API
Gérez l’approvisionnement API et les justificatifs de paiement dans Facturation API, avec les moyens de paiement actuellement activés. Créez et gérez vos clés séparément dans Clés API.
Les bonus des packs du site, les récompenses d’invitation et les autres crédits offerts sur le site n’alimentent pas le solde API. La taille des packs, les délais de remboursement et les règles d’expiration du site ne définissent pas les conditions d’approvisionnement API.
Quel solde est utilisé
Les identifiants et l’interface déterminent le solde débité :
| Appel ou interface | Solde utilisé |
|---|---|
API REST ou compatible avec une clé sk-popnow- | USD API |
| Playground sur une page de modèle API | USD API |
| MCP authentifié par clé API | USD API |
| Génération sur le site ou MCP connecté par OAuth | Crédits du site |
Approvisionner un solde ne recharge pas l’autre. Si une requête API ne peut pas couvrir sa réservation, ajoutez des fonds API plutôt que d’acheter des crédits du site.
Comment une génération est tarifée
Chaque modèle a sa propre grille tarifaire, définie pour chaque option : par image, par seconde de vidéo ou d’audio, par chanson, ou par tranche de 1 000 caractères de synthèse vocale. Le prix dépend de ce que vous demandez : résolution, durée, niveau de qualité et, pour certains modèles, le nombre de fichiers de référence envoyés.
Quelques exemples de prix API en USD :
| Modèle | Ce que vous obtenez | USD |
|---|---|---|
| Z-Image Turbo | Une image | $0.01 |
| Nano Banana 2.1 | Une image en 1K / 2K / 4K | $0.048 / $0.072 / $0.162 |
| Seedream 5.0 Pro | Une image en 1K / 2K | $0.036 / $0.072 |
| MiniMax H3 | Image vers vidéo, 768p, 5 secondes | $0.185 |
| Suno v6 | Une chanson | $0.072 |
| Background Remover | Un PNG transparent | $0.0048 |
| Image Upscaler | Une photo, agrandie | $0.012 |
Modèles renvoie aux pages de référence. Demandez un devis actuel pour vos réglages et conservez la précision décimale USD, jusqu’à neuf décimales ; n’arrondissez pas les débits API à des crédits entiers. Le Playground des pages API utilise le même solde API en USD.
Demandez le montant exact avant de lancer quoi que ce soit :
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`);Quand une tâche échoue
Lorsqu’une tâche est acceptée, son prix maximal en USD est mis de côté sur le solde API sous forme de réservation. À la fin :
| Résultat | Ce que vous payez |
|---|---|
succeeded | Le débit réel en USD, sans dépasser la réservation ; le montant inutilisé est libéré |
failed ou expired | Rien ; la réservation est libérée, sauf frais de refus de contenu propres à certains modèles |
| Refus pour des raisons de contenu | Rien, sauf pour les modèles dont la page indique que les refus sont facturés |
Rejet avant le démarrage (400, 402, 403, 429 …) | Rien ; pas de tâche, pas de réservation |
Une réservation libérée rétablit les fonds API disponibles ; ce n’est pas un remboursement vers votre banque ou carte. Lisez costUsd avec settled sur la tâche pour connaître le montant final en USD. Voir Facturation API.
Remboursements de paiements API
Pour toute question sur un paiement d’approvisionnement API ou un remboursement, ouvrez Facturation API ou contactez le support. Indiquez la référence du paiement ou l’identifiant de tâche, jamais votre clé API.
Erreurs possibles
| Code | Signification | Que faire |
|---|---|---|
40201 | Les USD API disponibles ne couvrent pas la réservation | Approvisionnez Facturation API, ou réduisez la résolution, la durée ou le nombre de sorties |
40202 | La tâche dépasserait un plafond de dépense de la clé | Augmentez ou supprimez le plafond dans Clés API, ou attendez sa réinitialisation |
40901 | Le prix a changé depuis votre devis | Demandez un nouveau devis et affichez le nouveau prix en USD |
Tous les codes figurent sur la page Erreurs.
Les appels API coûtent-ils plus cher que la génération sur le site ?
Non. Le même modèle avec les mêmes réglages utilise le même tarif. Les appels API sont facturés en USD sur le solde API ; les générations du site et les appels MCP par OAuth dépensent des crédits du site. Les soldes restent séparés.
Dois-je demander la libération d’une réservation de tâche ?
Non. Les tâches échouées et expirées libèrent automatiquement leur réservation, sous réserve des frais de refus de contenu propres à certains modèles. Consultez le costUsd définitif de la tâche pour connaître le montant final en USD.
Puis-je faire rembourser un paiement d’approvisionnement API ?
Pour connaître les conditions de remboursement ou obtenir de l’aide concernant un paiement API, ouvrez Facturation API ou contactez le support.
Les fonds API suivent-ils les règles d’expiration des crédits du site ?
Les règles d’expiration des packs et récompenses du site ne définissent pas les conditions API. Consultez Facturation API ou interrogez le support à propos de vos fonds API.
Puis-je approvisionner l’API avec des crédits du site ?
Non. Ajoutez des fonds API dans Facturation API. Les crédits du site ne financent pas l’API, les fonds API ne paient pas les générations du site, et les soldes ne sont pas transférables.
Voir aussi
Facturation API
Réservations, devis, solde, rapports d’usage et plafonds de dépense de l’API.
Modèles
Chaque identifiant de modèle avec sa grille tarifaire.
Erreurs
Chaque code d’erreur et la marche à suivre.
Console de facturation API
Gérer les fonds API, les justificatifs de paiement et les questions de facturation.

