Modèles

Chaque modèle que vous pouvez appeler a un identifiant de modèle, à placer dans le champ model de createTask. Le tableau en bas de cette page les liste tous avec leur prix de départ ; chaque nom mène à une page de référence avec la liste complète des paramètres, les paliers de prix et une requête à copier.

Comment se construit un identifiant

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker est celui qui a conçu le modèle. Les outils créés par PopNow utilisent popnow.
• model garde les points de sa version : seedance-2.0, pas seedance-2-0.
• task indique ce que fait l’appel : text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio, etc. L’édition d’image se termine toujours par edit.

Une famille de modèles a en général plusieurs identifiants, un par tâche. Choisissez celui qui correspond à ce que vous envoyez : .../text-to-video ne prend qu’un prompt, .../image-to-video demande une image de départ.

Lire le catalogue depuis le code

C’est le catalogue en direct qui fait foi : il dit ce qui est disponible maintenant et quels prix s’appliquent à votre compte.

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Filtres de la liste : modality (image, video, audio), provider, task, search, plus includeSchema=1 et includeExamples=1 pour ajouter les schémas d’entrée et des exemples d’entrées validés. Si votre client HTTP traite un paramètre de chemin comme un seul segment, encodez les barres obliques en %2F.

Les champs utiles

Lire les prix

credits est le même prix que celui affiché sur popnow.ai, en crédits (1 crédit = 0,01 $) :

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit indique comment le prix évolue (per_image, per_second, per_request, per_1k_characters), perUnit est le prix de départ, et chaque règle s’applique quand la requête correspond à ses valeurs when (* désigne le réglage qui fixe le palier, ici resolution). Le montant final d’une tâche est arrondi au crédit supérieur.

Pour le montant exact d’une requête précise, interrogez jobs/quote avec le corps que vous enverriez à createTask.

Schémas d’entrée

inputSchema est un schéma JSON standard (draft 2020-12). Quelques règles valent pour tous les modèles :

• Les champs inconnus sont refusés. Un aspect_ration mal orthographié renvoie 400 au lieu d’être ignoré en silence.
• Les noms de champs sont communs aux modèles. Une même idée porte toujours le même nom : prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• Les valeurs par défaut sont complétées pour vous. N’envoyez que ce que vous voulez changer.
• Les champs média acceptent une URL HTTPS publique, un fichier popnow:// envoyé par vos soins ou une ressource enregistrée. Voir Médias.
• Les indications d’affichage se trouvent dans un objet x-ui sur chaque propriété (libellés, ordre, pas des curseurs). Elles ne changent jamais la validation ; ignorez les clés que vous ne connaissez pas.

Si vous omettez seed sur un modèle qui en a un, une valeur aléatoire est choisie et renvoyée dans l’input de la tâche, pour reproduire un résultat qui vous plaît.

Mise en cache

Les réponses du catalogue sont propres à votre compte et peuvent être mises en cache 60 secondes. Un bon réflexe : garder la liste en cache quelques minutes, relire un modèle quand sa version change, et traiter available: false comme « réessayer plus tard ou choisir un autre modèle ».

Tous les modèles disponibles

Les prix indiqués sont le palier le plus bas par unité ; résolutions plus élevées, clips plus longs et options supplémentaires coûtent davantage. La page de chaque modèle détaille tous les paliers.