Saltar para o conteúdo principal
GET
/
replicate
/
v1
/
predictions
/
{id}
Query a Replicate prediction
curl --request GET \
  --url https://api.cometapi.com/replicate/v1/predictions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "input": {},
  "model": "<string>",
  "output": [
    "<string>"
  ],
  "status": "<string>",
  "created_at": "<string>",
  "data_removed": true,
  "logs": "<string>",
  "urls": {
    "get": "<string>",
    "cancel": "<string>",
    "stream": "<string>"
  },
  "error": "<string>",
  "metrics": {
    "image_count": 123,
    "predict_time": 123
  },
  "version": "<string>",
  "started_at": "<string>",
  "completed_at": "<string>"
}
Use este endpoint depois que você já tiver um id de prediction do Replicate. Ele informa o estado atual da tarefa e retorna URLs de saída quando a prediction é concluída.

Verifique estes campos primeiro

  • status para ver se a prediction ainda está em execução ou já foi finalizada
  • output para URLs dos recursos gerados
  • error para falhas do lado do provedor
  • metrics quando você precisar de detalhes sobre o tempo de execução ou a quantidade de imagens

Padrão de polling

1

Crie a prediction primeiro

2

Faça polling pelo id da prediction

Continue consultando até que status se torne terminal e output seja preenchido ou um erro do provedor seja retornado.
3

Persista os recursos finalizados

Trate as URLs dos recursos retornados como URLs de entrega e mova-as para seu próprio armazenamento se precisar de retenção por longo prazo.
Durante a validação ao vivo em 2026-03-12, o wrapper de consulta do CometAPI não retornou dentro de uma janela de smoke test de 45 segundos. Verifique a latência do polling no seu próprio ambiente antes de depender de loops curtos.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Parâmetros de caminho

id
string
obrigatório

Prediction id returned by the create endpoint.

Resposta

200 - application/json

Current prediction state.

id
string
obrigatório
input
object
obrigatório
model
string
obrigatório
output
string[] | null
obrigatório
status
string
obrigatório
created_at
string
obrigatório
data_removed
boolean
obrigatório
logs
string
urls
object
error
string | null
metrics
object
version
string
started_at
string | null
completed_at
string | null