Skip to content

Hookestdocs Postman OpenAPI llms.txt

PUTupload_url0 credits

Upload the clip

Send the MP4 to upload_url from Get upload link. This request is not on api.hookest.com.

Use the exact upload_url from the previous response. Postman fills the collection variable after Get upload link.
PUT the raw .mp4. No Bearer. Header Content-Type: video/mp4.
Max 40 MB on this PUT. Max 32 seconds is checked after the file lands — a longer clip can still return 2xx, then failed (unsupported) and a refund.
A 2xx means the file arrived. Then Get prediction. queued means 20 credits are reserved and scoring started. If it stays awaiting_upload, call Retry start — the PUT cannot return 402.

Postman

Open Score a clip → Upload the clip.
Body → binary → Select File → pick the .mp4.
Auth is already off. Do not add a Bearer header.
Send.

Do not attach the file to /v1/predict/upload or /v1/predict. Those routes do not accept the MP4.

Request parameters

Name	In	Type	Required	Description
`Content-Type`	header	string	Required	Must be `video/mp4`.
`body`	body	binary	Required	Raw MP4 bytes. Not JSON. No `Authorization` header.

hookest — zsh

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary @clip.mp4

const res = await fetch(uploadUrl, {
  method: "PUT",
  headers: { "Content-Type": "video/mp4" },
  body: file, // File or Blob — the MP4
});

import requests

with open("clip.mp4", "rb") as f:
    res = requests.put(
        upload_url,
        headers={"Content-Type": "video/mp4"},
        data=f,
    )

$ch = curl_init($uploadUrl);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => ["Content-Type: video/mp4"],
  CURLOPT_POSTFIELDS => file_get_contents("clip.mp4"),
]);
curl_exec($ch);

package main

import (
  "net/http"
  "os"
)

func main() {
  f, _ := os.Open("clip.mp4")
  defer f.Close()
  req, _ := http.NewRequest("PUT", uploadUrl, f)
  req.Header.Set("Content-Type", "video/mp4")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
}