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, 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/quote renvoie expectedChargeUsd et maxChargeUsd sous forme de chaînes décimales USD sans démarrer de tâche.
  • Lisez 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 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 interfaceSolde utilisé
API REST ou compatible avec une clé sk-popnow-USD API
Playground sur une page de modèle APIUSD API
MCP authentifié par clé APIUSD API
Génération sur le site ou MCP connecté par OAuthCré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è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 à 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}}'
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 ; la réservation est libérée, sauf frais de refus de contenu propres à certains modèles
Refus pour des raisons de contenuRien, 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

CodeSignificationQue faire
40201Les USD API disponibles ne couvrent pas la réservationApprovisionnez 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 ; 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.

Sur cette page