Listar modelos
GET /v1/models
Devuelve los modelos de imagen y vídeo disponibles ahora mismo. Solo aparecen los que tienen credenciales configuradas y están activos, así que la lista puede cambiar: pídela al arrancar tu aplicación en vez de fijar ids en el código.
Petición
bash
curl https://open.pikpikgo.com/v1/models \
-H "Authorization: Bearer $PIKPIK_API_KEY"Respuesta
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 }
]
}
]
}Campos
| Campo | Descripción |
|---|---|
| id | Identificador del modelo. Es el valor que se pasa en model; un id que no esté en esta lista se rechaza en vez de sustituirse en silencio por el predeterminado |
| type | image, video o text |
| credits | Precio unitario. Por imagen en modelos de imagen; por petición en modelos de vídeo sin especificaciones |
| max_reference_images | Cuántas imágenes de referencia admite. 0 significa que no las admite |
| aspect_ratios | Solo vídeo. Proporciones que admite este modelo; un array vacío significa sin restricción. Se rechaza cualquier proporción fuera de la lista |
| supports_last_frame | Solo vídeo. false significa que el modelo solo admite el primer fotograma; pasar image_last se rechaza |
| max_reference_videos | Solo vídeo. Cuántos vídeos de referencia admite. 0 significa que no los admite |
| max_reference_audios | Solo vídeo. Cuántos audios de referencia admite. 0 significa que no los admite |
| specs | Niveles disponibles. Al pasar spec, la resolución y el precio salen del nivel |
| specs[].credits | Precio de vídeo: billing=per_sec multiplica por la duración; billing=per_unit no |
| specs[].min_sec / max_sec | Rango de duración permitido en segundos. Los valores fuera de rango se ajustan |
En imagen y vídeo, si omites model se usa el modelo por defecto de la plataforma, que puede cambiar con el tiempo: indícalo de forma explícita si necesitas estabilidad. Las entradas con type text son para /v1/chat/completions, donde model es obligatorio y no tiene valor por defecto.