Hookestdocs Postman OpenAPI llms.txt

Score a clip

Three calls. The file never goes on api.hookest.com.

  1. Get upload link — empty POST with Bearer. Returns a one-time upload_url.
  2. Upload the clip — PUT the MP4 to that URL. No Bearer. A 2xx means the file arrived, not that scoring started.
  3. Get prediction — poll. Stop on succeeded or failed. 20 credits reserve when status becomes queued.

If GET stays awaiting_upload after a 2xx upload, call Retry start. Duration is read from the file (max 32s). Needs predict:write on the key. This is a permission on the key, not a request header. Missing it returns 403 api_not_enabled.