POST/v1/predict0 o 20 créditos

Retry start

No es el happy path. Solo si GET sigue awaiting_upload tras un upload 2xx. El mismo upload_id. Ya queued: la misma prediction, 0 créditos.

Es un permiso de la clave, no un header. Si falta: 403 api_not_enabled.

Parámetros de la petición

Nombre	En	Tipo	Obligatorio	Descripción
`upload_id`	body	string	Obligatorio	Del enlace, `upl_` más 32 hex. Solo JSON.

Respuesta

{
  "object": "prediction",
  "id": "pred_7b3e0c1d2e3f4a5b6c7d8e9f0a1b2c3d",
  "status": "queued",
  "created_at": "2026-09-15T14:02:11.000Z",
  "completed_at": null,
  "input": { "duration_sec": 18 },
  "result": null,
  "error": null
}

Campos de respuesta

Nombre	Tipo	Obligatorio	Descripción
`object`	string	Obligatorio	Siempre `prediction`.
`id`	string	Obligatorio	Id público, `pred_` más 32 hex.
`status`	string	Obligatorio	`awaiting_upload`, `queued`, `running`, `succeeded` o `failed`.
`created_at`	string	Obligatorio	Cuándo se creó el job.
`completed_at`	string	Nullable	Al terminar. `null` si no.
`input`	object	Nullable	Entrada aceptada, o `null`.
`input.duration_sec`	number	Nullable	Si hay `input`.
`result`	object	Nullable	Score en éxito. `null` antes y en fallo.
`result.band`	string	Opcional	Si hay `result`.
`result.hook_duration_sec`	number	Nullable	Si hay `result`.
`result.category`	object	Nullable	Si hay `result`. Puede ser `null`.
`result.category.slug`	string	Opcional	Si hay `result.category`.
`error`	object	Nullable	En fallo. Si no, `null`.
`error.type`	string	Opcional	En fallo: `unsupported`, `unsafe` o `system_error`.
`error.message`	string	Opcional	En fallo. Texto en inglés.