API de PicassoIA
Predicciones
Una predicción es una ejecución de un modelo: la creas, la consultas y lees su salida.
Crear una predicción
POST /v1/models/{owner}/{name}/predictions con el cuerpo { "input": { … } }.
- La API responde en cuanto el modelo acepta el trabajo, normalmente en pocos segundos, con la predicción en el estado
starting. Nunca espera al resultado. - Si la predicción falla de inmediato, la respuesta sigue siendo
201, con la predicción en el estadofailedy suerror. Esto ocurre, por ejemplo, cuando el filtro de seguridad rechaza la entrada. - Si no se ha creado ninguna predicción, la respuesta es un error: entrada no válida, plan insuficiente, demasiadas predicciones en curso, servicio no disponible.
Listar predicciones
GET /v1/predictions devuelve tus predicciones de la API, 50 por página, de la más reciente a la más antigua, incluidas las de todas tus API keys.
nextes la URL de la página siguiente (…/v1/predictions?cursor=…), onullen la última página.previoussiempre esnull.- Las predicciones que hayas eliminado en picassoia.com no aparecen.
Una predicción es visible desde cualquiera de tus API keys, y nunca para nadie más.
El objeto de predicción
Estados.
La distinción entre starting y processing es una estimación, calculada a partir de la posición en la cola en el momento de la creación. Una predicción nueva siempre está en starting. Los tres últimos estados son definitivos: una predicción que está en uno de ellos ya no vuelve a cambiar.
Errores de una predicción fallida. El error de una predicción fallida es uno de estos mensajes:
- El filtro de seguridad ha rechazado la entrada o la salida. El mensaje termina en
(SAFETY_CHECKER_PICASSO_FILTER_S4). The prediction failed. You can try again.The prediction timed out. You can try again.La predicción no terminó en un plazo de 3 horas.
Salidas. Las URL de salida están alojadas en PicassoIA. Descarga los archivos que quieras conservar.
Sondeo y ETA
eta.next_poll_in_seconds te indica cuándo merece la pena hacer la siguiente consulta:
- A la mitad del tiempo estimado.
- Cuando se alcanza el tiempo estimado.
- Después, cada 2 segundos.
Ejemplo con una estimación de 10 s: consulta a los 5 s, luego a los 10 s y, a partir de ahí, cada 2 s. Consultar con más frecuencia no te dará el resultado antes.
Cancelación
POST /v1/predictions/{id}/cancel:
Una predicción cancelada libera al instante su plaza entre tus 5 predicciones en curso.