Lister les modèles
GET /v1/models
Renvoie les modèles d’image et de vidéo actuellement disponibles. Seuls ceux dont les identifiants sont configurés et le statut actif apparaissent : la liste peut donc évoluer. Récupérez-la au démarrage de votre application plutôt que de figer des ids.
Requête
bash
curl https://open.pikpikgo.com/v1/models \
-H "Authorization: Bearer $PIKPIK_API_KEY"Réponse
json
{
"object": "list",
"data": [
{
"id": "img-std-1",
"object": "model",
"type": "image",
"credits": 10,
"max_reference_images": 4,
"specs": [
{ "key": "2k", "name": "2K", "resolution": "2k", "quality": "2k", "credits": 10, "min_sec": 0, "max_sec": 0 }
]
}
]
}Champs
| Champ | Description |
|---|---|
| id | Identifiant du modèle. C’est la valeur à passer dans model ; un id absent de cette liste est refusé, et non remplacé en silence par le modèle par défaut |
| type | image, video ou text |
| credits | Tarif unitaire. Par image pour les modèles d’image ; par requête pour les modèles vidéo sans paliers |
| max_reference_images | Nombre d’images de référence acceptées. 0 signifie non pris en charge |
| aspect_ratios | Vidéo uniquement. Formats d’image acceptés par ce modèle ; un tableau vide signifie aucune restriction. Tout format absent de la liste est refusé |
| supports_last_frame | Vidéo uniquement. false signifie que le modèle n’accepte que la première image ; image_last est refusé |
| max_reference_videos | Vidéo uniquement. Nombre de vidéos de référence acceptées. 0 signifie non pris en charge |
| max_reference_audios | Vidéo uniquement. Nombre d’audios de référence acceptés. 0 signifie non pris en charge |
| specs | Paliers disponibles. Avec spec, la résolution et le tarif viennent du palier |
| specs[].credits | Tarif vidéo : billing=per_sec multiplie par la durée ; billing=per_unit ne la multiplie pas |
| specs[].min_sec / max_sec | Plage de durée autorisée en secondes. Les valeurs hors plage sont ramenées aux bornes |
Pour l’image et la vidéo, sans model le modèle par défaut de la plateforme s’applique, et il peut changer avec le temps : précisez-le explicitement si vous avez besoin de stabilité. Les entrées de type text servent à /v1/chat/completions, où model est obligatoire et sans valeur par défaut.