Skip to main content
POST

​
Request

Send a POST request to below endpoint.
curl

​
Load a ckpt or safetensors Model from Civitai

json

​
Load a diffusers model

json

Body

application/json
​
key
string
required

Your API Key used for request authorization

​
url
string
required

The URL of the Huggingface model, CKPT download link, or Safetensors model

​
model_id
string
required

Choose a name (ID) for your model. The loaded model will be saved under this ID

​
model_format
enum<string>
required

Available options are "diffusers", "safetensors", or "ckpt"

Available options:
diffusers,
safetensors,
ckpt
​
model_category
enum<string>
required

The category of the model you want to upload

Available options:
stable_diffusion,
stable_diffusion_xl,
flux,
z_image
​
model_visibility
enum<string>
default:public
required

It accepts "private" or "public"

Available options:
private,
public
​
model_name
string
required

The name you want to give your model

​
force_load
enum<string>
default:yes

Set this to "yes" if you want to reload automatically once upload fails; otherwise pass "no"

Available options:
yes,
no
​
revision
enum<string>
default:fp16

Specify whether the loaded model is "fp16" or "fp32"

Available options:
fp16,
fp32
​
model_subcategory
enum<string>

for lora models, specify the model sub category as lora

Available options:
lora
​
model_image
string<uri>

A valid image URL to display the model when uploaded

​
hf_upload
enum<string>
default:no

It accepts "yes" or "no"

Available options:
yes,
no

Response

Model load started successfully

​
status
string
Example:

"success"

​
message
string
Example:

"model load started"