Ir al contenido

ControlNet SDXL

Integrar

Id del modelo fast-sdxl-controlnet-canny
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/fast-sdxl-controlnet-canny?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitud: ≈0,015 $ 15 créditos de API · ≈ 1,58 ₽ Ejecutar en esta página

Obtener clave de API
Stability AI Texto a imagen Rápido #diffusion#controlnet#manipulation

Texto a imagen con SDXL guiado por una imagen de control para generar con la composición bloqueada

Stability AI · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio

Describe la imagen que quieres generar con el mayor detalle posible para obtener los mejores resultados.

•obligatorio
Suelta un archivo o

URL de la imagen de control.

image_size

Dimensiones de salida, determinadas automáticamente a partir de la imagen de control cuando no se proporciona un tamaño.

num_images predeterminado 1

Cantidad de imágenes solicitada para la generación.

Avanzado negative_prompt · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · loras · embeddings
predeterminado

Prompt negativo que especifica los detalles de imagen que deben excluirse, incluidos colores, objetos, escenarios o características más precisas. Algunos ejemplos son bigote, desenfoque o baja resolución.

safety_checker_version predeterminado v1

Elija entre un comprobador de seguridad ViT personalizado (`v2`) y el comprobador CompVis (`v1`, el predeterminado).

format predeterminado jpeg

Formato de archivo de la imagen resultante.

predeterminado

Identificador de la solicitud para correlacionar una respuesta con la solicitud que la produjo.

predeterminado 0.5

Intensidad del condicionamiento aplicado por ControlNet.

predeterminado 35

Cantidad de pasos de inferencia que se ejecutarán.

predeterminado 7.5

Intensidad de adhesión al prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).

Semilla para reproducir imágenes en Stable Diffusion. Una imagen puede reproducirse exactamente en cada ejecución si se mantienen sin cambios la versión del modelo, el prompt y la semilla.

predeterminado []

Pesos LoRA seleccionados para su uso, proporcionados como una lista.

predeterminado []

Embeddings seleccionados para su uso, proporcionados como una lista.

POST /run/fast-sdxl-controlnet-canny?wait=20 cotización → 0,015 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/fast-sdxl-controlnet-canny?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y se guarda (localStorage) únicamente si marcas Recordar. Obtener una clave de API

Acerca de ControlNet SDXL

Genera imágenes a partir de un `prompt` y un `control_image_url` obligatorio que guía la composición. `controlnet_conditioning_scale` va de 0 a 1 (valor predeterminado 0.5). El tamaño de salida se infiere de la imagen de control, salvo que se establezca `image_size`. Admite hasta 8 imágenes por llamada, hasta 70 pasos, LoRA y embeddings.

Parámetros

Envía el nombre canónico o el nombre nativo, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
Describe la imagen que quieres generar con el mayor detalle posible para obtener los mejores resultados.
control_image_urlobligatorio
Tipourl · image
URL de la imagen de control.
controlnet_conditioning_scaleopcional
Tiponumber
Predeterminado0.5
0 – 1
Intensidad del condicionamiento aplicado por ControlNet.
negative_promptopcional
Tipostring
Predeterminado
Prompt negativo que especifica los detalles de imagen que deben excluirse, incluidos colores, objetos, escenarios o características más precisas. Algunos ejemplos son bigote, desenfoque o baja resolución.
image_sizeopcional
Tipoobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiones de salida, determinadas automáticamente a partir de la imagen de control cuando no se proporciona un tamaño.
num_inference_stepsopcional
Tipointeger
Predeterminado35
1 – 70
Cantidad de pasos de inferencia que se ejecutarán.
seedopcional
Tipointeger | null
Semilla para reproducir imágenes en Stable Diffusion. Una imagen puede reproducirse exactamente en cada ejecución si se mantienen sin cambios la versión del modelo, el prompt y la semilla.
guidance_scaleopcional
Tiponumber
Predeterminado7.5
0 – 20
Intensidad de adhesión al prompt para la selección de imágenes, expresada como CFG (Classifier Free Guidance).
num_imagesopcional num_outputs
Tipointeger
Predeterminado1
1 – 8
Cantidad de imágenes solicitada para la generación.
lorasopcional
Tipoobject[]
Predeterminado[]
Pesos LoRA seleccionados para su uso, proporcionados como una lista.
loras[].forceopcional
Tipoboolean
Predeterminadofalse
Indica si el uso de embeddings es obligatorio: true lo hace obligatorio.
loras[].pathobligatorio
Tipostring
Fuente de los pesos LoRA, proporcionada como un identificador de modelo HF que resuelve a pesos safetensors o como un archivo safetensors ubicado mediante una URL o una ruta.
loras[].scaleopcional
Tiponumber
Predeterminado1
0 – 1
Multiplicador aplicado al peso de LoRA antes de combinarlo con el modelo base.
embeddingsopcional
Tipoobject[]
Predeterminado[]
Embeddings seleccionados para su uso, proporcionados como una lista.
embeddings[].pathobligatorio
Tipostring
Pesos de embeddings especificados mediante una URL o una ruta de archivo.
embeddings[].tokensopcional
Tipostring[]
Lista de tokens de embeddings, con nombres automáticos cuando se omite: cada vector del archivo de embeddings recibe un token de la secuencia <s0>, <s1>, ... .
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
Activación del comprobador de seguridad; true activa la comprobación.
safety_checker_versionopcional
Tipoenum
Predeterminadov1
v1v2
Elija entre un comprobador de seguridad ViT personalizado (`v2`) y el comprobador CompVis (`v1`, el predeterminado).
expand_promptopcional
Tipoboolean
Predeterminadofalse
Expansión del prompt con prompts adicionales, habilitada cuando es true.
formatopcional
Tipoenum
Predeterminadojpeg
jpegpng
Formato de archivo de la imagen resultante.
request_idopcional
Tipostring
Predeterminado
Identificador de la solicitud para correlacionar una respuesta con la solicitud que la produjo.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una carga. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fast-sdxl-controlnet-canny",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 15,
    "usd": "0.015",
    "charged": 15,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (se cobra por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
images
array of object {url, width, height, content_type}Información de los archivos de las imágenes generadas.
timings
object
seed
integerSemilla de generación de imágenes, incluido el valor elegido aleatoriamente si la entrada omitió una semilla; de lo contrario, repite el valor proporcionado.
has_nsfw_concepts
array of booleanIndica si aparecen conceptos NSFW en las imágenes generadas.
prompt
stringPrompt utilizado durante la generación de imágenes.

Más modelos: Texto a imagen

Para agentes de IA: esta página en Markdown está en https://doitong.com/es/developers/models/fast-sdxl-controlnet-canny.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt