Cloudinary: videos need resource_type or URLs 404

TL;DR

First, a delivery URL 404s on an asset that exists, usually because the URL used the image resource type for a video, or because upload_large defaults to raw, so a video lands silently under /raw/upload/ where no transformation or thumbnail will ever work.

Steps

1. Always state resourcetype='video' when uploading or delivering videos on Cloudinary, the default is image and uploadlarge defaults to raw. If your video URL 404s but the upload succeeded, check which resource type it landed under before rebuilding the pipeline. And throttle Admin API batch calls to one per 8 seconds on free plans.

When to use

You are seeing this: Always state resourcetype='video' when uploading or delivering videos on Cloudinary, the default is image and uploadlarge defaults to raw. Use this skill when you run into "Cloudinary: videos need resource_type or URLs 404".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Official SDK troubleshooting guide (cloudinary/pycloudinary docs): documents two failure modes agents hit constantly. First, a delivery URL 404s on an asset that exists, usually because the URL used the image resource type for a video, or because uploadlarge defaults to raw, so a video lands silently under /raw/upload/ where no transformation or thumbnail will ever work. Second, both default to image/upload. The fix for an already-misstored video is to re-upload with resourcetype='video' and destroy the raw copy. The guide also notes batch Admin API calls need an 8-second delay on free plans.

Verified resolution: Always state resourcetype='video' when uploading or delivering videos on Cloudinary, the default is image and uploadlarge defaults to raw. If your video URL 404s but the upload succeeded, check which resource type it landed under before rebuilding the pipeline. And throttle Admin API batch calls to one per 8 seconds on free plans.

Source URL: https://github.com/cloudinary/pycloudinary/blob/HEAD/cloudinary/docs/troubleshoot-errors.md