Blobs

Upload a blob directly with on-the-fly moderation. Supports both authenticated requests (Bearer token) and presigned URLs (sig query param).

Changed on
post/v2/consumer/blobs

Request

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

Query parameters

publicboolean

Store the blob in the public tier and return a durable, unsigned URL for it. Privileged callers only: nothing gates a read of that URL, so a block decided after the fact cannot take it back.

Response

Created

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