Comment fonctionne l’API PopNow
Ce que l’API sait produire, les cinq notions sur lesquelles reposent toutes les pages, et dans quel ordre les lire.
L’API PopNow permet à vos propres logiciels d’utiliser les modèles d’image, de vidéo et d’audio que vous connaissez sur popnow.ai. Mêmes modèles, mêmes prix, mêmes crédits — simplement appelés depuis du code plutôt que cliqués dans un navigateur.
Ce que vous pouvez produire
| Résultat | Exemples |
|---|---|
| Images | Texte vers image, retouche avec une ou plusieurs références, agrandissement, détourage, séparation en calques |
| Vidéo | Texte vers vidéo, image vers vidéo, vidéo à première et dernière image imposées, vidéo de référence, prolongation et montage de clips, synchronisation labiale, avatars parlants |
| Audio | Musique, effets sonores, synthèse vocale, bande-son pour une vidéo existante, transcription |
La liste complète, avec l’identifiant et le prix de chaque modèle, se trouve dans Modèles. L’API couvre uniquement la génération d’images, de vidéos et d’audio ; les modèles de chat et de texte n’en font pas partie.
Cinq notions que vous croiserez partout
Identifiant de modèle
Tout ce que vous pouvez appeler a un identifiant de la forme <maker>/<model>/<task>, par exemple alibaba/wan-3.0/image-to-video ou google/nano-banana-2.1/edit. Il va dans le champ model de chaque requête. L’édition d’image se termine toujours par /edit. Les outils créés par PopNow, comme le détourage, ont popnow pour éditeur.
Tâche
Une génération prend de quelques secondes à plusieurs minutes : chaque requête crée donc une tâche. Vous recevez aussitôt un taskId et lisez le résultat quand il est prêt. Une tâche passe de queued à running, puis à un état final : succeeded, failed ou expired. Détails : Tâches.
Crédits
L’API consomme les mêmes crédits que le site. Un crédit vaut 0,01 $ au tarif de base. Quand une tâche est acceptée, son prix maximal est réservé ; quand elle se termine, vous payez le montant réel (jamais plus que la réservation) et le reste est libéré. Une tâche en échec ne coûte rien. Détails : Crédits et facturation.
Clé d’idempotence
Un délai dépassé ne vous dit pas si le serveur a reçu votre requête. Envoyez un en-tête Idempotency-Key avec chaque tâche que vous créez : une nouvelle tentative avec la même clé renvoie la tâche d’origine au lieu d’en créer — et d’en facturer — une deuxième. Détails : Idempotence.
Webhook
Plutôt que d’interroger une tâche en boucle, donnez-lui une callBackUrl. Quand la tâche se termine, PopNow envoie le résultat complet à cette URL, signé pour que vous puissiez vérifier qu’il vient bien de nous. Détails : Webhooks.
À quoi ressemble une requête
POST https://api.popnow.ai/api/v1/jobs/createTask
Authorization: Bearer sk-popnow-...
Idempotency-Key: 7d0c9a52-...
{ "model": "alibaba/wan-3.0/image-to-video",
"input": { "image_url": "https://…/photo.jpg", "prompt": "The waves roll in slowly" },
"callBackUrl": "https://your-app.example.com/hooks/popnow" }Toutes les réponses utilisent la même enveloppe, { "code", "msg", "data", "request_id" }, où code: 200 signifie succès.
L’ordre de lecture
- Démarrage rapide — votre premier résultat en cinq minutes.
- Authentification — protéger une clé et limiter ce qu’elle peut faire.
- Modèles — choisir un modèle et lire ses paramètres.
- Tâches et Webhooks — le cycle de vie complet.
- Médias — envoyer vos propres images, vidéos et audios.
- Erreurs et Limites de débit — avant la mise en production.
Envie d’essayer un modèle avant d’écrire du code ? Chaque modèle a un Playground sur sa page API de popnow.ai, qui tourne sur votre compte sans clé.