Uploads

Upload a file (get an upload URL) — estimate

Price the request without executing it. Same body as POST /v1/studio/uploads.

post/v1/studio/uploads/estimate

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/studio/uploads/estimate
  • Auth: HTTP bearer

Request body

creditstring

Optional — the credit line (Creative Commons)

license'own' | 'creative-commons' | 'licensed'

Optional — your basis for using the file, kept with the upload and listed with its job (GET /v1/usage?tag= → sources): own = you made it · creative-commons = published under CC BY (keep the credit line on screen) · licensed = written permission from the owner. Send it for a video you will dub or republish

filenamestring required
size_bytesinteger

The file size — recommended: the upload must then match it exactly. At most 2 GB for video and audio, 100 MB for images

source_urlstring uri

Optional — where the file was published (e.g. its YouTube link), kept with the licence

content_typestring

video/mp4, video/quicktime, video/webm, audio/mpeg, audio/wav, audio/mp4, image/jpeg, image/png, image/webp, image/gif…

Example request

{
  "filename": "clip.mp4",
  "content_type": "video/mp4"
}

Response

Estimate

operationstring
estimated_creditsnumber
credits_to_reservenumber
estimated_usageobject
notestring nullable
sufficientboolean

Changes

No recorded changes to this operation across all 2 revisions of this API.