PicassoIA API
Previsões
Uma previsão é uma execução de um modelo: você a cria, a consulta e lê a saída dela.
Criar uma previsão
POST /v1/models/{owner}/{name}/predictions com o corpo { "input": { … } }.
- A API responde assim que o modelo aceita o trabalho, geralmente em poucos segundos, com a previsão no estado
starting. Ela nunca espera pelo resultado. - Se a previsão falhar imediatamente, a resposta continua sendo
201, com a previsão no estadofailede o seuerror. Isso acontece, por exemplo, quando a entrada é recusada pelo filtro de segurança. - Se nenhuma previsão tiver sido criada, a resposta é um erro: entrada inválida, plano, previsões demais em andamento, serviço indisponível.
Listar previsões
GET /v1/predictions retorna as suas previsões da API, 50 por página, das mais recentes para as mais antigas, considerando todas as suas chaves.
nexté a URL da próxima página (…/v1/predictions?cursor=…), ounullna última página.previousé semprenull.- As previsões que você excluiu em picassoia.com não são incluídas.
Uma previsão fica visível por meio de qualquer uma das suas chaves, e nunca para outras pessoas.
O objeto de previsão
Estados.
A distinção entre starting e processing é uma estimativa, feita a partir da posição na fila no momento da criação. Uma previsão nova está sempre em starting. Os três últimos estados são finais: uma previsão em um deles nunca mais muda.
Erros de uma previsão com falha. O error de uma previsão com falha é uma destas mensagens:
- A entrada ou a saída foi recusada pelo filtro de segurança. A mensagem termina em
(SAFETY_CHECKER_PICASSO_FILTER_S4). The prediction failed. You can try again.The prediction timed out. You can try again.A previsão não foi concluída em até 3 horas.
Saídas. As URLs de saída são hospedadas pela PicassoIA. Baixe os arquivos que você quiser manter.
Consulta periódica e ETA
eta.next_poll_in_seconds indica quando vale a pena fazer a próxima consulta:
- Na metade do tempo estimado.
- Quando a estimativa é atingida.
- Depois, a cada 2 segundos.
Exemplo com uma estimativa de 10 s: consulte após 5 s, depois após 10 s e, então, a cada 2 s. Consultar com mais frequência não traz o resultado mais cedo.
Cancelamento
POST /v1/predictions/{id}/cancel:
Uma previsão cancelada libera imediatamente o lugar que ocupava entre as suas 5 previsões em andamento.