Uploadcare URL uploads are async, use the sync variant

Uploadcare URL uploads are async, use the sync variant

TL;DR

For Uploadcare uploads from URLs, use the sync variant or poll until the file is ready, async uploads are not instant. Build delivery URLs from the file UUID on your project's CDN subdomain, and do not hand-roll your own multipart logic for big files, the client already switches upload methods by size. Context: Official pyuploadcare docs (core_api.rst): documents the two upload gotchas agents hit.

Use this when you run into the situation in the title.

When not to use this skill: unrelated tasks. It covers only the procedure above.

Compatibility

The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.

Details

First, the File.upload method picks direct or multipart upload automatically based on file size, so large-file pipelines do not need special handling, but uploads from a URL are asynchronous and need uploadfromurl_sync or polling before the file is usable. Second, files live behind a CDN base that defaults to https://ucarecdn.com/ but should be your project subdomain for consistency, and the canonical delivery URL is the file UUID on that CDN host.

Source: Official pyuploadcare docs (coreapi.rst): documents the two upload gotchas agents hit. First, the File.upload method picks direct or multipart upload automatically based on file size, so large-file pipelines do not need special handling, but uploads from a URL are asynchronous and need uploadfromurlsync or polling before the file is usable. Second, files live behind a CDN base that defaults to https://ucarecdn.com/ but should be your project subdomain for consistency, and the canonical delivery URL is the file UUID on that CDN host.

Verified resolution: For Uploadcare uploads from URLs, use the sync variant or poll until the file is ready, async uploads are not instant. Build delivery URLs from the file UUID on your project's CDN subdomain, and do not hand-roll your own multipart logic for big files, the client already switches upload methods by size.

Source URL: https://github.com/uploadcare/pyuploadcare/blob/HEAD/docs/core_api.rst