Upload media - CarHub Documentation

Most image endpoints accept either a multipart file or an upload reference. Videos and multi-asset requests require an upload reference.

Choose an input encoding

Encoding	Use it when	Input field
`multipart/form-data`	You have one small asset ready to send	`image`, `audio`, `video` or `images[]`
`application/json`	You upload first, send video, or submit a batch	`input_ref` or `input_refs`

Multipart uploads are capped at 10 MB per file. The model’s parameters are the same in either encoding.

Create and use an upload

Create a presigned upload with POST /v1/uploads.
Upload the original bytes to the returned presigned URL. Preserve the URL and signed request headers exactly.
Submit input_ref (or input_refs) in JSON to the inference endpoint.

{
  "input_ref": "upl_7Qm2hV9tXbLd",
  "params": {"return_cutout": true}
}

An upload reference is opaque and organisation-scoped. Do not attempt to construct one or share it across organisations. CarHub resolves the reference server-side and rejects inaccessible or consumed objects.

For field names, content types and endpoint-specific parameters, use the generated API reference.

⌘I