PopNowDocs API
Solde API et facturation
Contenu principal

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. Les appels avec clé API, le MCP pour développeurs et les exécutions du Playground sur les pages API le consomment. Un modèle coûte le même prix sur l’API que sur popnow.ai pour les mêmes réglages.

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 propre. Seuls les fonds API ajoutés dans la facturation API alimentent ce solde, et ils ne servent qu’à l’API.
  • Demandez un devis avant l’exécution. jobs/quote renvoie expectedChargeUsd et maxChargeUsd sous forme de chaînes décimales USD sans démarrer de tâche.
  • Vérifiez le montant définitif. Le costUsd d’une tâche est son débit final en USD lorsque settled vaut true. Les tâches échouées ou expirées libèrent automatiquement le montant réservé.

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.

Ce qui débite le solde API

Appel ou interfacePrélevé sur
API REST ou compatible avec une clé sk-popnow-Solde API
Playground sur une page de modèle APISolde API
MCP pour développeurs avec clé APISolde API
Exécutions de recettes enregistrées via l’API ou le MCP pour développeursSolde API

Si une requête API ne peut pas couvrir sa réservation, ajoutez des fonds API dans Facturation API.

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èleCe que vous obtenezUSD
Z-Image TurboUne image$0.01
Nano Banana 2.1Une image en 1K / 2K / 4K$0.048 / $0.072 / $0.162
Seedream 5.0 ProUne image en 1K / 2K$0.036 / $0.072
MiniMax H3Image vers vidéo, 768p, 5 secondes$0.185
Suno v6Une chanson$0.072
Background RemoverUn PNG transparent$0.0048
Image UpscalerUne 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. 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}}'
Python
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")
JavaScript
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ésultatCe que vous payez
succeededLe débit réel en USD, sans dépasser la réservation ; le montant inutilisé est libéré
failed ou expiredRien ; le montant réservé est libéré
Refus pour des raisons de contenuRien
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

CodeSignificationQue faire
40201Les USD API disponibles ne couvrent pas la réservationAjoutez des fonds dans Facturation API, ou réduisez la résolution, la durée ou le nombre de sorties
40202La 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
40901Le prix a changé depuis votre devisDemandez 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.

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 le montant réservé. 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.

Sur cette page