Guía de migración de API V2 a V3

Texto a imagen

Mapeo de parámetros del cuerpo de la solicitud

V2	V3	Descripción
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		En desuso
response_image_type Enum: `png`, `jpeg`	response_image_type Enum: `png, webp, jpeg`	V3 agrega compatibilidad con el formato de imagen `webp`
	requestobject	Campo nuevo Todos los parámetros de generación de imágenes deben pasarse mediante `request`en V3
promptstring <lora:$sd_name:$weight>	promptstring	Movido dentro
	lorasobject[]	Movido dentro Migra el uso de LoRA: del parámetro `prompt` al parámetro `request.loras`
	model_namestring	Campo nuevo Nombre de lora; recupera el valor sd_name_in_api correspondiente invocando el endpoint Get Model API con filter.types=lora como parámetro de consulta.
	strengthnumber(float32)	Campo nuevo El valor de intensidad de lora. Cuanto mayor sea el valor, más sesgado estará el efecto hacia lora; rango [0, 1]
negative_promptstring	negative_promptstring	Movido dentro
sampler_namestring	sampler_namestring	Movido dentro
batch_sizeinteger	image_numinteger	Cambiado `num_images` → `request.image_num`
n_iter		En desuso
stepsstring	stepsstring	Movido dentro
cfg_scaleinteger	guidance_scale number(float32)	Cambiado `cfg_scale`→ `request.guidance_scale`
seedinteger	seedinteger	Movido dentro
heightinteger	heightinteger	Movido dentro Cambio de rango: [128, 2048].
widthinteger	widthinteger	Movido dentro Cambio de rango: [128, 2048].
model_namestring	model_namestring	Movido dentro Este parámetro especifica el nombre del checkpoint del modelo. Recupera el valor sd_name correspondiente invocando la API Query Model con filter.types=checkpoint como parámetro de consulta.
restore_facesbool	restore_facesbool	Movido dentro
restore_faces_model		En desuso
sd_vaestring	sd_vaestring	Movido dentro
clip_skipinteger	clip_skipinteger	Movido dentro
enable_hrboolean	hires_fixobject	Cambiado `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`	Cambiado `hr_upscaler`→`request.hires_fix.upscaler`
hr_scalenumber		En desuso
hr_resize_xinteger	target_widthinteger	Cambiado `hr_resize_x`→ `request.hires_fix.target_width`
hr_resize_yinteger	target_heightinteger	Cambiado `hr_resize_y`→ `request.hires_fix.target_height`
img_expire_ttlinteger		En desuso Predeterminado 3600s
sd_refinerobject	refinerobject	Cambiado `sd_refiner`→ `request.refiner`
checkpointstring		En desuso
switch_at number(float32)	switch_at number(float32)	Cambiado `sd_refiner.switch_at`→ `request.refiner.switch_at`
controlnet_unitsobject[]		En desuso Solo `img2img`

Mapeo de parámetros de respuesta

V2	V3	Descripción
code		En desuso
msg		En desuso
data		En desuso
task_id	task_id	Cambiado `data.task_id`→ `task_id`
warn		En desuso

Ejemplo

Texto a imagen V2

Solicitud

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
}'

Respuesta

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

Texto a imagen V3

Solicitud

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
          }
        ]
    }
}'

Respuesta

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

Imagen a imagen

Mapeo de parámetros del cuerpo de la solicitud

V2	V3	Descripción
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		En desuso
response_image_type Enum: `png`, `jpeg`	response_image_type Enum: `png, webp, jpeg`	V3 agrega compatibilidad con el formato de imagen `webp`
	requestobject	Campo nuevo Todos los parámetros de generación de imágenes deben pasarse mediante `request`en V3
promptstring <lora:$sd_name:$weight>	promptstring	Movido dentro
	lorasobject[]	Movido dentro Migra el uso de LoRA: del parámetro `prompt` al parámetro `request.loras`
	model_namestring	Campo nuevo Nombre de lora; recupera el valor sd_name_in_api correspondiente invocando el endpoint Get Model API con filter.types=lora como parámetro de consulta.
	strength number(float32)	Campo nuevo El valor de intensidad de lora. Cuanto mayor sea el valor, más sesgado estará el efecto hacia lora; rango [0, 1]
negative_promptstring	negative_prompt string	Movido dentro
sampler_namestring	sampler_namestring	Movido dentro
batch_sizeinteger	image_numinteger	Cambiado `batch_size`→ `request.image_num`
n_iterinteger		En desuso
stepsstring	stepsstring	Movido dentro
cfg_scaleinteger	guidance_scale number(float32)	Cambiado `cfg_scale`→ `request.guidance_scale`
seedinteger	seedinteger	Movido dentro
heightinteger	heightinteger	Movido dentro Cambio de rango: [128, 2048].
widthinteger	widthinteger	Movido dentro Cambio de rango: [128, 2048].
model_namestring	model_namestring	Movido dentro Este parámetro especifica el nombre del checkpoint del modelo. Recupera el valor sd_name correspondiente invocando la API Query Model con filter.types=checkpoint como parámetro de consulta.
init_imagesstring[]	image_base64string	Cambiado `init_images`→ `request.image_base64`
denoising_strength number(float)	strength number(float)	Cambiado `denoising_strength`→ `request.strength`
restore_facesbool		En desuso
sd_vaestring	sd_vaestring	Movido dentro
clip_skipinteger	clip_skipinteger	Movido dentro
maskstring		En desuso Recomendación: usa la API V3 Inpainting
mask_blurinteger		En desuso Recomendación: usa la API V3 Inpainting
resize_modeinteger		En desuso
image_cfg_scaleinteger		En desuso
inpainting_fillinteger		En desuso Recomendación: usa la API V3 Inpainting
inpaint_full_resinteger		En desuso Recomendación: usa la API V3 Inpainting
inpaint_full_res_padding integer		En desuso Recomendación: usa la API V3 Inpainting
inpainting_mask_invert integer		En desuso Recomendación: usa la API V3 Inpainting
initial_noise_multiplier number(float32)		En desuso
img_expire_ttlinteger		En desuso Predeterminado 3600s
sd_refinerobject	refinerobject	Cambiado `sd_refiner`→ `request.refiner`
checkpoint		En desuso
switch_at number(float32)	switch_at number(float32)	Movido dentro
	controlnetobject	Campo nuevo
controlnet_unitsobject[]	unitsobject[]	Cambiado `controlnet_units`→ `request.controlnet.units`
modelstring	model_name string	Cambiado `controlnet_units.model`→ `request.controlnet.units.model_name`
weightnumber	strength number(float32)	Cambiado `controlnet_units.weight`→ `request.controlnet.units.strength`
input_imagestring	image_base64 string	Cambiado `controlnet_units.input_image`→ `request.controlnet.units.image_base64`
modulestring,Enum	preprocessor string,Enum	Cambiado `controlnet_units.module`→ `request.controlnet.units.preprocessor`
control_mode		En desuso
mask		En desuso Recomendación: usa la API V3 Inpainting
resize_mode		En desuso
processor_res		En desuso
threshold_a		En desuso
threshold_b		En desuso
guidance_start number(float32)	guidance_start number(float32)	Movido dentro
guidance_end number(float32)	guidance_end number(float32)	Movido dentro
pixel_perfect		En desuso

Mapeo de parámetros de respuesta

V2	V3	Descripción
code		En desuso
msg		En desuso
data		En desuso
task_id	task_id	Cambiado `data.task_id`→ `task_id`
warn		En desuso

Ejemplo

Imagen a imagen V2

Solicitud

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
  }
}'

Respuesta

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

Imagen a imagen V3

Solicitud

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
        }
      ]
    }
  }
}'

Respuesta

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

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Guía de migración de API V2 a V3

Texto a imagen

Mapeo de parámetros del cuerpo de la solicitud

Mapeo de parámetros de respuesta

Ejemplo

Texto a imagen V2

Texto a imagen V3

Imagen a imagen

Mapeo de parámetros del cuerpo de la solicitud

Mapeo de parámetros de respuesta

Ejemplo

Imagen a imagen V2

Imagen a imagen V3

​Texto a imagen

​Mapeo de parámetros del cuerpo de la solicitud

​Mapeo de parámetros de respuesta

​Ejemplo

Texto a imagen V2

Texto a imagen V3

​Imagen a imagen

​Mapeo de parámetros del cuerpo de la solicitud

​Mapeo de parámetros de respuesta

​Ejemplo

Imagen a imagen V2

Imagen a imagen V3

Texto a imagen

Mapeo de parámetros del cuerpo de la solicitud

Mapeo de parámetros de respuesta

Ejemplo

Imagen a imagen

Mapeo de parámetros del cuerpo de la solicitud

Mapeo de parámetros de respuesta

Ejemplo