Sign in
Blobs

Copy a trusted url into a blob named after that source, so the caller can ask for it again without holding the bytes. 200 when it already existed, 201 when copied.

Changed on
post/v2/consumer/blobs/ingest

Request

  • The document declares no server URL.
  • Auth: none required

Query parameters

sourceUrlstring

Object to copy; must resolve to a configured trusted source.

publicboolean

Store in the public tier and return a durable, unsigned URL.

Response

OK

typestring required
idstring required
availableboolean required
urlstring uri nullable
urlExpiresAtstring date-time nullable
jobIdstring nullable
nsfwLevel'pg' | 'pg13' | 'r' | 'x' | 'xxx' | 'na'
blockedReasonstring nullable
tierstring nullable

Deprecated: use Civitai.Orchestration.Grains.Workflows.Steps.Common.Blob.PublicUrl to tell a public blob. Get the storage tier holding this blob, when one was declared. Null resolves to the private managed tier, falling back to the classic one for blobs written before producers moved off it.

publicUrlstring uri nullable

The durable, unsigned url of a blob requested public, which a CDN can cache. Set as soon as the blob is requested, so it may 404 until the workflow that produces it completes; Civitai.Orchestration.Grains.Workflows.Steps.Common.Blob.Url waits instead.

Changes