Migratiehandleiding van API V2 naar V3

Tekst naar afbeelding

Parameterkoppeling voor request body

V2	V3	Beschrijving
extraobject	extraobject
enable_nsfw_detection boolean	enable_nsfw_detection boolean
nsfw_detection_level Enum: `0, 1, 2`	nsfw_detection_level Enum: `0, 1, 2`
enable_progress_info		Verouderd
response_image_type Enum: `png`, `jpeg`	response_image_type Enum: `png, webp, jpeg`	V3 voegt ondersteuning toe voor de `webp`afbeeldingsindeling
	requestobject	Nieuw veld Alle parameters voor afbeeldingsgeneratie moeten in V3 via de `request`worden doorgegeven
promptstring <lora:$sd_name:$weight>	promptstring	Naar binnen verplaatst
	lorasobject[]	Naar binnen verplaatst Migreer LoRA-gebruik: van `prompt` naar parameter `request.loras`****
	model_namestring	Nieuw veld Naam van lora; haal de bijbehorende sd_name_in_api-waarde op door het Get Model API-endpoint aan te roepen met filter.types=lora als queryparameter.
	strengthnumber(float32)	Nieuw veld De strength-waarde van lora. Hoe groter de waarde, hoe sterker het effect richting lora wordt gestuurd. Bereik [0, 1]
negative_promptstring	negative_promptstring	Naar binnen verplaatst
sampler_namestring	sampler_namestring	Naar binnen verplaatst
batch_sizeinteger	image_numinteger	Gewijzigd `num_images` → `request.image_num`
n_iter		Verouderd
stepsstring	stepsstring	Naar binnen verplaatst
cfg_scaleinteger	guidance_scale number(float32)	Gewijzigd `cfg_scale`→ `request.guidance_scale`
seedinteger	seedinteger	Naar binnen verplaatst
heightinteger	heightinteger	Naar binnen verplaatst Bereikwijziging: [128, 2048].
widthinteger	widthinteger	Naar binnen verplaatst Bereikwijziging: [128, 2048].
model_namestring	model_namestring	Naar binnen verplaatst Deze parameter specificeert de naam van de modelcheckpoint. Haal de bijbehorende sd_name-waarde op door de Query Model API aan te roepen met filter.types=checkpoint als queryparameter.
restore_facesbool	restore_facesbool	Naar binnen verplaatst
restore_faces_model		Verouderd
sd_vaestring	sd_vaestring	Naar binnen verplaatst
clip_skipinteger	clip_skipinteger	Naar binnen verplaatst
enable_hrboolean	hires_fixobject	Gewijzigd `enable_hr`→ `request.hires_fix`
hr_upscaler Enum: `Latent`, `ESRGAN_4x`, `R-ESRGAN 4x+`, `R-ESRGAN 4x+ Anime6B`	upscaler Enum: `RealESRGAN_x4plus_anime_6B`, `RealESRNet_x4plus,Latent`	Gewijzigd `hr_upscaler`→`request.hires_fix.upscaler`
hr_scalenumber		Verouderd
hr_resize_xinteger	target_widthinteger	Gewijzigd `hr_resize_x`→ `request.hires_fix.target_width`
hr_resize_yinteger	target_heightinteger	Gewijzigd `hr_resize_y`→ `request.hires_fix.target_height`
img_expire_ttlinteger		Verouderd Standaard 3600s
sd_refinerobject	refinerobject	Gewijzigd `sd_refiner`→ `request.refiner`
checkpointstring		Verouderd
switch_at number(float32)	switch_at number(float32)	Gewijzigd `sd_refiner.switch_at`→ `request.refiner.switch_at`
controlnet_unitsobject[]		Verouderd Alleen `img2img`

Parameterkoppeling voor response

V2	V3	Beschrijving
code		Verouderd
msg		Verouderd
data		Verouderd
task_id	task_id	Gewijzigd `data.task_id`→ `task_id`
warn		Verouderd

Voorbeeld

Tekst naar afbeelding V2

Request

curl --location "https://api.novita.ai/v2/txt2img" \
--header "Authorization: Bearer {{API Key}}" \
--header "Content-Type: application/json" \
--data '{
  "extra": {
    "enable_nsfw_detection": false,
    "nsfw_detection_level": 0,
    "response_image_type": "jpeg"
  },
  "prompt": "(masterpiece, best quality, ultra-detailed:1.3), <lora:AnimeStyle_XL_v1_AutoRunMech_103883:0.8>, 1girl, mecha armor, futuristic city background, glowing neon lights, dynamic pose, cyberpunk style, intricate mechanical details, (floating holographic interface:1.2), sparkling blue eyes, wind-blown hair, (steam and energy particles:1.1), cinematic lighting",
  "negative_prompt":"(worst quality, low quality:1.4), (deformed, distorted:1.3), disfigured, blurry, bad anatomy, extra limbs, (mutated hands:1.2), (text, watermark:1.5), 
overexposed, underexposed, (cartoonish:1.2), (simplistic background:1.3), 
grainy, (traditional drawing:1.2), (realistic:1.4), (noisy:1.3)",
  "sampler_name":"DPM++ 2M Karras",
  "batch_size": 1,
  "n_iter": 1,
  "steps": 25,
  "cfg_scale": 7,
  "seed": 65531,
  "height": 512,
  "width": 512,
  "model_name": "sd_xl_base_1.0.safetensors",
  "restore_faces": false,
  "restore_faces_model": "",
  "sd_vae": "",
  "clip_skip": 1,
  "enable_hr": true,
  "hr_upscaler": "Latent",
  "hr_scale": 2,
  "hr_resize_x": 1024,
  "hr_resize_y": 1024,
  "img_expire_ttl": 3600
}'

Response

{
  "code": 0,
  "msg": "",
  "data": {
    "task_id": "12905b6a-d436-4010-b199-d800130c0aab"
  }
}

Tekst naar afbeelding V3

Request

curl --location 'https://api.novita.ai/v3/async/txt2img' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'Content-Type: application/json' \
--data '{
    "extra": {
        "enable_nsfw_detection": false,
        "nsfw_detection_level": 0,
        "response_image_type": "jpeg"
    },
    "request": {
      "prompt": "(masterpiece, best quality, ultra-detailed:1.3), 1girl, mecha armor, futuristic city background, glowing neon lights, dynamic pose, cyberpunk style, intricate mechanical details,(floating holographic interface:1.2), sparkling blue eyes, wind-blown hair, (steam and energy particles:1.1), cinematic lighting",
      "negative_prompt": "(worst quality, low quality:1.4), (deformed, distorted:1.3), disfigured,blurry, bad anatomy, extra limbs, (mutated hands:1.2), (text, watermark:1.5),overexposed, underexposed,(cartoonish:1.2), (simplistic background:1.3), grainy, (traditional drawing:1.2),(realistic:1.4), (noisy:1.3)",
        "model_name": "sd_xl_base_1.0.safetensors",
        "width": 512,
        "height": 512,
        "image_num": 1,
        "steps": 25,
        "seed": 65531,
        "restore_faces": false,
        "clip_skip": 1,
        "sampler_name":"DPM++ 2M Karras",
        "guidance_scale": 7,
        "hires_fix": {
            "target_width": 1024,
            "target_height": 1024,
            "strength": 0.8,
            "upscaler": "Latent"
        },
        "loras": [
          {
            "model_name": "AnimeStyle_XL_v1_AutoRunMech_103883",
            "strength": 0.8
          }
        ]
    }
}'

Response

{
  "task_id":"0696ce57-22df-4a89-9efc-80c386a82dbd"
}

Afbeelding naar afbeelding

Parameterkoppeling voor request body

V2	V3	Beschrijving
extraobject	extraobject
enable_nsfw_detection boolean	enable_nsfw_detection boolean
nsfw_detection_level Enum: `0, 1, 2`	nsfw_detection_level Enum: `0, 1, 2`
enable_progress_info		Verouderd
response_image_type Enum: `png`, `jpeg`	response_image_type Enum: `png, webp, jpeg`	V3 voegt ondersteuning toe voor de `webp`afbeeldingsindeling
	requestobject	Nieuw veld Alle parameters voor afbeeldingsgeneratie moeten in V3 via de `request`worden doorgegeven
promptstring <lora:$sd_name:$weight>	promptstring	Naar binnen verplaatst
	lorasobject[]	Naar binnen verplaatst Migreer LoRA-gebruik: van `prompt` naar parameter `request.loras`****
	model_namestring	Nieuw veld Naam van lora; haal de bijbehorende sd_name_in_api-waarde op door het Get Model API-endpoint aan te roepen met filter.types=lora als queryparameter.
	strength number(float32)	Nieuw veld De strength-waarde van lora. Hoe groter de waarde, hoe sterker het effect richting lora wordt gestuurd. Bereik [0, 1]
negative_promptstring	negative_prompt string	Naar binnen verplaatst
sampler_namestring	sampler_namestring	Naar binnen verplaatst
batch_sizeinteger	image_numinteger	Gewijzigd `batch_size`→ `request.image_num`
n_iterinteger		Verouderd
stepsstring	stepsstring	Naar binnen verplaatst
cfg_scaleinteger	guidance_scale number(float32)	Gewijzigd `cfg_scale`→ `request.guidance_scale`
seedinteger	seedinteger	Naar binnen verplaatst
heightinteger	heightinteger	Naar binnen verplaatst Bereikwijziging: [128, 2048].
widthinteger	widthinteger	Naar binnen verplaatst Bereikwijziging: [128, 2048].
model_namestring	model_namestring	Naar binnen verplaatst Deze parameter specificeert de naam van de modelcheckpoint. Haal de bijbehorende sd_name-waarde op door de Query Model API aan te roepen met filter.types=checkpoint als queryparameter.
init_imagesstring[]	image_base64string	Gewijzigd `init_images`→ `request.image_base64`
denoising_strength number(float)	strength number(float)	Gewijzigd `denoising_strength`→ `request.strength`
restore_facesbool		Verouderd
sd_vaestring	sd_vaestring	Naar binnen verplaatst
clip_skipinteger	clip_skipinteger	Naar binnen verplaatst
maskstring		Verouderd Aanbeveling: gebruik V3 Inpainting API
mask_blurinteger		Verouderd Aanbeveling: gebruik V3 Inpainting API
resize_modeinteger		Verouderd
image_cfg_scaleinteger		Verouderd
inpainting_fillinteger		Verouderd Aanbeveling: gebruik V3 Inpainting API
inpaint_full_resinteger		Verouderd Aanbeveling: gebruik V3 Inpainting API
inpaint_full_res_padding integer		Verouderd Aanbeveling: gebruik V3 Inpainting API
inpainting_mask_invert integer		Verouderd Aanbeveling: gebruik V3 Inpainting API
initial_noise_multiplier number(float32)		Verouderd
img_expire_ttlinteger		Verouderd Standaard 3600s
sd_refinerobject	refinerobject	Gewijzigd `sd_refiner`→ `request.refiner`
checkpoint		Verouderd
switch_at number(float32)	switch_at number(float32)	Naar binnen verplaatst
	controlnetobject	Nieuw veld
controlnet_unitsobject[]	unitsobject[]	Gewijzigd `controlnet_units`→ `request.controlnet.units`
modelstring	model_name string	Gewijzigd `controlnet_units.model`→ `request.controlnet.units.model_name`
weightnumber	strength number(float32)	Gewijzigd `controlnet_units.weight`→ `request.controlnet.units.strength`
input_imagestring	image_base64 string	Gewijzigd `controlnet_units.input_image`→ `request.controlnet.units.image_base64`
modulestring,Enum	preprocessor string,Enum	Gewijzigd `controlnet_units.module`→ `request.controlnet.units.preprocessor`
control_mode		Verouderd
mask		Verouderd Aanbeveling: gebruik V3 Inpainting API
resize_mode		Verouderd
processor_res		Verouderd
threshold_a		Verouderd
threshold_b		Verouderd
guidance_start number(float32)	guidance_start number(float32)	Naar binnen verplaatst
guidance_end number(float32)	guidance_end number(float32)	Naar binnen verplaatst
pixel_perfect		Verouderd

Parameterkoppeling voor response

V2	V3	Beschrijving
code		Verouderd
msg		Verouderd
data		Verouderd
task_id	task_id	Gewijzigd `data.task_id`→ `task_id`
warn		Verouderd

Voorbeeld

Afbeelding naar afbeelding V2

Request

curl --request POST \
  --url https://api.novita.ai/v2/img2img \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "extra": {
    "enable_nsfw_detection": false,
    "nsfw_detection_level": 0,
    "response_image_type": "png"
  },
  "prompt": "realistic, photograph, (masterpiece), 8k quality, (detailed eyes:1.2), (highest quality:1.1), highly detailed, majestic, top quality, best quality, newest, ai-generated, (intricate details:1.1), extremely beautiful, elegant, majestic, immersive background+, (detailed face, perfect face), In the heart of a vibrant garden, a girl with red hair and brown eyes sits in contemplation of the nature around her.",
  "negative_prompt": "(worst quality:1.5), (low quality:1.5), (normal quality:1.5), anime, cartoon, painting, drawing, illustration, manga, sketch, nudity, young, child, hairband, headband, horns, lowres, bad anatomy, bad hands, multiple eyebrow, (cropped), extra limb, missing limbs, deformed hands, long neck, long body, long torso, (bad hands), signature, username, artist name, conjoined fingers, deformed fingers, ugly eyes, imperfect eyes, skewed eyes, unnatural face, unnatural body, error, grain, jpeg artifacts",
  "sampler_name":"DPM++ 2M Karras",
  "batch_size": 1,
  "n_iter": 1,
  "steps": 25,
  "cfg_scale": 7.5,
  "seed": 765824,
  "height": 768,
  "width": 512,
  "model_name": "cyberrealistic_v31_62396.safetensors",
  "init_images": [
    "<IMAGE_BASE64>"
  ],
  "denoising_strength": 0.8,
  "restore_faces": false,
  "clip_skip": 1,
  "img_expire_ttl": 3600,
  "controlnet_units": {
    "model": "control_v11p_sd15_lineart",
    "weight": 1,
    "input_image": "<IMAGE_BASE64>",
    "module": "lineart",
    "guidance_start": 0,
    "guidance_end": 1
  }
}'

Response

{
  "code": 0,
  "msg": "",
  "data": {
    "task_id": "a1b0d99b-2ef0-4b20-8eeb-c641ae84ed45"
  }
}

Afbeelding naar afbeelding V3

Request

curl --request POST \
  --url https://api.novita.ai/v3/async/img2img \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "extra": {
    "enable_nsfw_detection": false,
    "nsfw_detection_level": 0,
    "response_image_type": "png"
  },
  "request": {
    "prompt": "realistic, photograph, (masterpiece), 8k quality, (detailed eyes:1.2), (highest quality:1.1), highly detailed, majestic, top quality, best quality, newest, ai-generated, (intricate details:1.1), extremely beautiful, elegant, majestic, immersive background+, (detailed face, perfect face), In the heart of a vibrant garden, a girl with red hair and brown eyes sits in contemplation of the nature around her.",
    "negative_prompt": "(worst quality:1.5), (low quality:1.5), (normal quality:1.5), anime, cartoon, painting, drawing, illustration, manga, sketch, nudity, young, child, hairband, headband, horns, lowres, bad anatomy, bad hands, multiple eyebrow, (cropped), extra limb, missing limbs, deformed hands, long neck, long body, long torso, (bad hands), signature, username, artist name, conjoined fingers, deformed fingers, ugly eyes, imperfect eyes, skewed eyes, unnatural face, unnatural body, error, grain, jpeg artifacts",
    "sampler_name": "DPM++ 2M Karras",
    "image_num": 1,
    "steps": 25,
    "guidance_scale": 7.5,
    "seed": 765824,
    "height": 768,
    "width": 512,
    "model_name": "cyberrealistic_v31_62396.safetensors",
        "image_base64": "<IMAGE_BASE64>",
    "strength": 0.8,
    "clip_skip": 1,
    "controlnet": {
      "units": [
        {
          "model_name": "control_v11p_sd15_lineart",
          "strength": 1,
          "image_base64": "<IMAGE_BASE64>",
          "preprocessor": "lineart",
          "guidance_start": 0,
          "guidance_end": 1
        }
      ]
    }
  }
}'

Response

{
  "task_id": "9490dde7-cd28-493e-9db0-8a38a65bf5e6"
}

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Migratiehandleiding van API V2 naar V3

Tekst naar afbeelding

Parameterkoppeling voor request body

Parameterkoppeling voor response

Voorbeeld

Tekst naar afbeelding V2

Tekst naar afbeelding V3

Afbeelding naar afbeelding

Parameterkoppeling voor request body

Parameterkoppeling voor response

Voorbeeld

Afbeelding naar afbeelding V2

Afbeelding naar afbeelding V3

​Tekst naar afbeelding

​Parameterkoppeling voor request body

​Parameterkoppeling voor response

​Voorbeeld

Tekst naar afbeelding V2

Tekst naar afbeelding V3

​Afbeelding naar afbeelding

​Parameterkoppeling voor request body

​Parameterkoppeling voor response

​Voorbeeld

Afbeelding naar afbeelding V2

Afbeelding naar afbeelding V3

Tekst naar afbeelding

Parameterkoppeling voor request body

Parameterkoppeling voor response

Voorbeeld

Afbeelding naar afbeelding

Parameterkoppeling voor request body

Parameterkoppeling voor response

Voorbeeld