POST/v1/predict0 oder 20 Credits

Retry start

Kein Happy Path. Nur wenn GET nach 2xx-Upload awaiting_upload bleibt. Dieselbe upload_id. Schon queued: dieselbe Prediction, 0 Credits.

Das ist eine Berechtigung am Key, kein Request-Header. Fehlt sie, kommt 403 api_not_enabled.

Request-Parameter

Name	In	Typ	Pflicht	Beschreibung
`upload_id`	body	string	Pflicht	Von Upload-Link, `upl_` plus 32 Hex. Nur JSON.

Antwort

{
  "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
}

Antwortfelder

Name	Typ	Pflicht	Beschreibung
`object`	string	Pflicht	Immer `prediction`.
`id`	string	Pflicht	Public id, `pred_` plus 32 Hex.
`status`	string	Pflicht	`awaiting_upload`, `queued`, `running`, `succeeded` oder `failed`.
`created_at`	string	Pflicht	Wann der Job angelegt wurde.
`completed_at`	string	Nullable	Gesetzt, wenn der Job endet. Sonst `null`.
`input`	object	Nullable	Akzeptierter Input oder `null`.
`input.duration_sec`	number	Nullable	Wenn `input` gesetzt ist.
`result`	object	Nullable	Score bei Erfolg. Sonst `null`.
`result.band`	string	Optional	Wenn `result` gesetzt ist.
`result.hook_duration_sec`	number	Nullable	Wenn `result` gesetzt ist.
`result.category`	object	Nullable	Wenn `result` gesetzt ist. Kann selbst `null` sein.
`result.category.slug`	string	Optional	Wenn `result.category` gesetzt ist.
`error`	object	Nullable	Bei Fehler gesetzt. Sonst `null`.
`error.type`	string	Optional	Bei Fehler: `unsupported`, `unsafe` oder `system_error`.
`error.message`	string	Optional	Bei Fehler. Englischer Text.