Référence de l’API

Tous les endpoints de l’API PopNow sur une seule page, avec des liens vers le contrat OpenAPI complet.

Le contrat complet, lisible par machine, est openapi.yaml (OpenAPI 3.1). Importez-le dans Postman, Insomnia ou un générateur de code, ou confiez-le à un agent IA. Cette page en est la carte à taille humaine.

URL de base : https://api.popnow.ai/api/v1 (routes compatibles OpenAI : https://api.popnow.ai/v1)
Authentification : Authorization: Bearer sk-popnow-… sur chaque requête
Enveloppe : { "code", "msg", "data", "request_id" } ; code: 200 signifie succès
Montants : en crédits entiers (credits, maxCredits…), chacun aussi donné en chaîne en dollars US ; 1 crédit = 0,01 $

Tâches

Méthode et chemin	Rôle	Page
`POST /jobs/createTask`	Créer une tâche de génération (`?wait=` facultatif, 60 s max)	Tâches
`GET /jobs/recordInfo?taskId=`	Lire l’état et le résultat d’une tâche	Tâches
`GET /jobs`	Lister les tâches de cette clé	Tâches
`POST /jobs/quote`	Chiffrer une requête sans l’exécuter	Facturation
`POST /jobs/retry`	Nouvelle tâche à partir d’une tâche en échec ou expirée	Tâches
`POST /jobs/purge`	Supprimer le contenu d’une tâche terminée	Tâches

Modèles

Méthode et chemin	Rôle	Page
`GET /models`	Tous les modèles disponibles et leurs prix (`?includeSchema=1` pour les schémas d’entrée)	Modèles
`GET /models/{model}`	Un modèle, avec son schéma d’entrée	Modèles

Fichiers et ressources

Méthode et chemin	Rôle	Page
`POST /common/upload-url`	Ticket pour un envoi direct	Médias
`POST /files/{fileId}/commit`	Terminer un envoi et obtenir son URI `popnow://`	Médias
`POST /files/import`	Importer un fichier LoRA depuis un lien	Ressources
`POST /common/download-url`	Nouveau lien signé vers le résultat d’une tâche	Médias
`GET /assets`, `POST /assets`	Lister ou enregistrer des ressources	Ressources
`GET`, `PATCH`, `DELETE /assets/{assetId}`	Lire, renommer ou supprimer une ressource	Ressources
`GET /assets/entities`	Vos personnages	Ressources
`GET /assets/usage`	Offre de stockage et usage	Ressources

Compte

Méthode et chemin	Rôle	Page
`GET /chat/credit`	Solde : disponible, réservé, total	Facturation
`GET /usage`	Usage de cette clé par jour et par modèle	Facturation

Compatible OpenAI Videos (`/v1`)

Méthode et chemin	Rôle	Page
`POST /v1/videos`	Créer une tâche vidéo	OpenAI Videos
`GET /v1/videos/{id}`	La lire	OpenAI Videos
`GET /v1/videos/{id}/content`	Rediriger vers le fichier	OpenAI Videos
`GET /v1/models`	Liste des modèles au format OpenAI	OpenAI Videos

En-têtes communs

En-tête	Sens	Signification
`Idempotency-Key`	Requête	Rend sûres pendant 24 heures les nouvelles tentatives d’une écriture (Idempotence)
`Accept-Language`	Requête	Langue des messages d’erreur (Erreurs)
`X-PopNow-Retention`	Requête	Raccourcir la conservation du contenu d’une tâche, en secondes
`X-Request-Id`	Réponse	Identique à `request_id` ; à communiquer au support
`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`	Réponse	Limites de débit (Limites de débit)