Civitai

Civitai is the largest open community for Stable Diffusion, SDXL, Flux, and video AI models — hosting over a million model checkpoints, LoRAs, embeddings, and VAEs uploaded and rated by creators. Beyond hosting, Civitai operates a hosted AI image, video, audio, and language generation service through its Orchestration API, which races workflows across providers (Flux 1/2, SDXL, SD1, Z-Image, Qwen, Seedream, Grok, WAN 2.1-2.7, Kling, LTX2, Vidu, Veo 3, HunyuanVideo) and supports LoRA training jobs. The Site API exposes the public catalog plus user vault, permissions, and AIR identifier resolution. OAuth 2.0 with PKCE and per-app Buzz spend caps lets third parties build delegated experiences without owning a user's full credit balance. Generation is metered in Buzz, a virtual credit topped up via memberships or one-off packs.

3 APIs 18 Features

AIArtificial IntelligenceImage GenerationVideo GenerationStable DiffusionSDXLFluxLoRAModel HostingCommunityGenerative AI

APIs

Civitai Site API

Browse and search the Civitai public catalog of Stable Diffusion, SDXL, Flux, and video models. The Site API exposes models, model versions, images, creators, tags, users, permi...

Civitai Orchestration API

Submit AI generation workflows — image, video, audio, language, and LoRA training — through a single contract at `https://orchestration.civitai.com`. Races multiple providers an...

Civitai OAuth API

OAuth 2.0 authorization-code with PKCE for third-party apps that act on behalf of a Civitai user. Supports scoped tokens, refresh flow, and per-app Buzz spend caps so a delegate...

Collections

Civitai Orchestration API

POSTMAN

Civitai Site API

POSTMAN

Civitai Orchestration API

OPEN

Civitai Site API

OPEN

Arazzo Workflows

Civitai Batch Hash Reconciliation

Resolve many file hashes to version ids in bulk, then enrich the first match with model detail.

ARAZZO

Civitai Blob Upload and Image-to-Image Generation

Upload a source image blob, run an img2img workflow against it, poll, and read the result.

ARAZZO

Civitai Creator Models and Image Gallery

Find a creator, list the models they publish, and pull a gallery of images for one model.

ARAZZO

Civitai Image Generation Submit and Poll

Submit an image generation workflow, poll until it finishes, and collect the output blobs.

ARAZZO

Civitai Model Images Explorer

Open a model, browse its community images, and resolve the version behind the top image.

ARAZZO

Civitai Identify a Model From a File Hash

Resolve a local model file's hash to its model version, then load the parent model.

ARAZZO

Civitai Generate From a Catalog Model Version

Resolve a catalog model version's AIR, generate an image with it, poll, and read the result.

ARAZZO

Civitai Permission-Gated Version Download

Resolve a model version, check the bearer's permissions, and branch on download rights.

ARAZZO

Civitai Presigned Blob Upload Then Generate

Request a presigned blob upload URL, reference the blob in a workflow with webhook callbacks, and poll.

ARAZZO

Civitai Search Models and Drill Into a Version

Search the model catalog, open the top matching model, and resolve one of its versions.

ARAZZO

Civitai Tag-Driven Model Discovery

Pick a tag from the taxonomy, list models carrying that tag, and open the top model.

ARAZZO

Civitai Vault Add and Verify

Confirm the user, check vault capacity, add a model version to the vault, and verify storage.

ARAZZO

Civitai Query and Cancel a Running Workflow

List active workflows, inspect the first one, cancel it, and confirm the canceled state.

ARAZZO

Pricing Plans

Civitai Plans Pricing

7 plans

PLANS

Rate Limits

Civitai Rate Limits

4 limits

RATE LIMITS

FinOps

Civitai Finops

FINOPS

Features

Largest community catalog of Stable Diffusion, SDXL, and Flux checkpoints, LoRAs, embeddings, and VAEs

Image, video, audio, and language generation through a single Orchestration API

Multi-provider workflow racing across Flux 1/2, SDXL, SD1, Z-Image, Qwen, Seedream, Grok, WAN, Kling, LTX2, Vidu, Veo 3, HunyuanVideo

LoRA training jobs for SDXL, Flux, WAN, and LTX2 ecosystems

AI Resource Identifier (AIR) URN scheme for unambiguously referencing models, versions, and weights

Bearer-token authentication via per-user API keys, plus OAuth 2.0 + PKCE for third-party apps

In-order, serialized webhooks for workflow, step, and job lifecycle events

HTTPS-only webhook endpoints with retry on non-2xx; idempotency keyed on `(workflowId, status, timestamp)`

Blob upload API with built-in NSFW moderation and presigned upload URLs

Buzz credit system for metering generation, with per-app spend caps on delegated OAuth tokens

Civitai Vault for membership-tier model storage and retrieval via API

Hash-based model-version lookup for client tools (ComfyUI, A1111, Civitai Link)

Public MCP server exposing Civitai as tools for Claude, Cursor, and other MCP-aware agents

Open-source Civitai platform repo (TypeScript) on GitHub

Official JavaScript SDK (`civitai-client-javascript`) and OAuth SDK (`civitai-app-starters`)

Civitai Link Desktop for syncing models into local Stable Diffusion installs

AI Toolkit for diffusion model finetuning; Model Scanner for safety/security checks

Education portal and community articles, posts, comics, challenges, and bounties

Semantic Vocabularies

Civitai Context

53 classes · 20 properties

JSON-LD

API Governance Rules

Civitai API Rules

10 rules · 3 errors 7 warnings

SPECTRAL

JSON Structure

Civitai Model Structure

0 properties

JSON STRUCTURE

Example Payloads

Civitai Image Generation Example

3 fields

EXAMPLE

Civitai Video Generation Example

3 fields

EXAMPLE

Resources

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

Documentation

Documentation

GettingStarted

Authentication

TermsOfService

PrivacyPolicy

ContentPolicy

GitHubRepository

GitHubRepository

GitHubRepository

GitHubRepository

Documentation

Documentation

Documentation

Sources

opencollection: 1.0.0
info:
  name: Civitai Site API
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Models
    type: folder
  items:
  - info:
      name: List Models
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/models
      params:
      - name: limit
        value: ''
        type: query
      - name: page
        value: ''
        type: query
      - name: query
        value: ''
        type: query
      - name: tag
        value: ''
        type: query
      - name: username
        value: ''
        type: query
      - name: types
        value: ''
        type: query
      - name: sort
        value: ''
        type: query
      - name: period
        value: ''
        type: query
      - name: nsfw
        value: ''
        type: query
    docs: List Models
  - info:
      name: Get Model
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/models/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get Model
- info:
    name: ModelVersions
    type: folder
  items:
  - info:
      name: Get Model Version
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/model-versions/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Get Model Version
  - info:
      name: Get Model Version Mini
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/model-versions/mini/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Lightweight model-version payload optimized for client tools.
  - info:
      name: Get Model Version By Hash
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/model-versions/by-hash/:hash
      params:
      - name: hash
        value: ''
        type: path
        description: AutoV1, AutoV2, SHA256, CRC32, or Blake3 hash of the model file.
    docs: Get Model Version By Hash
  - info:
      name: Get Model Versions By Hashes
      type: http
    http:
      method: POST
      url: https://civitai.com/api/v1/model-versions/by-hash
      body:
        type: json
        data: '{}'
    docs: Get Model Versions By Hashes
  - info:
      name: Get Model Version IDs By Hashes
      type: http
    http:
      method: POST
      url: https://civitai.com/api/v1/model-versions/by-hash/ids
      body:
        type: json
        data: '{}'
    docs: Get Model Version IDs By Hashes
- info:
    name: Images
    type: folder
  items:
  - info:
      name: List Images
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/images
      params:
      - name: limit
        value: ''
        type: query
      - name: postId
        value: ''
        type: query
      - name: modelId
        value: ''
        type: query
      - name: modelVersionId
        value: ''
        type: query
      - name: username
        value: ''
        type: query
      - name: nsfw
        value: ''
        type: query
      - name: sort
        value: ''
        type: query
      - name: period
        value: ''
        type: query
      - name: page
        value: ''
        type: query
    docs: List Images
- info:
    name: Creators
    type: folder
  items:
  - info:
      name: List Creators
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/creators
      params:
      - name: limit
        value: ''
        type: query
      - name: page
        value: ''
        type: query
      - name: query
        value: ''
        type: query
    docs: List Creators
- info:
    name: Tags
    type: folder
  items:
  - info:
      name: List Tags
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/tags
      params:
      - name: limit
        value: ''
        type: query
      - name: page
        value: ''
        type: query
      - name: query
        value: ''
        type: query
    docs: List Tags
- info:
    name: Users
    type: folder
  items:
  - info:
      name: Get Current User
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/me
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get Current User
  - info:
      name: List Users
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/users
      params:
      - name: username
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: List Users
- info:
    name: Permissions
    type: folder
  items:
  - info:
      name: Check Permissions
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/permissions/check
      params:
      - name: entityType
        value: ''
        type: query
      - name: entityId
        value: ''
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Check Permissions
- info:
    name: Vault
    type: folder
  items:
  - info:
      name: Get Vault Item
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/vault/get
      params:
      - name: modelVersionId
        value: ''
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get Vault Item
  - info:
      name: Get All Vault Items
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/vault/all
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Get All Vault Items
  - info:
      name: Check Vault Status
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/vault/check-vault
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Check Vault Status
  - info:
      name: Toggle Vault Version
      type: http
    http:
      method: POST
      url: https://civitai.com/api/v1/vault/toggle-version
      body:
        type: json
        data: '{}'
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: Toggle Vault Version
- info:
    name: Enums
    type: folder
  items:
  - info:
      name: Get Enums
      type: http
    http:
      method: GET
      url: https://civitai.com/api/v1/enums
    docs: Get Enums
bundled: true