Ir al contenido

Z Image Turbo Controlnet

Integrar

Id del modelo z-image/turbo/controlnet
# 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/z-image/turbo/controlnet?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",
    "image": "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,013 $ 13 créditos de API · ≈ 1,37 ₽ Ejecutar en esta página

Obtener clave de API
Alibaba · 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

Prompt que orienta la generación de imágenes.

•obligatorio image_url
Suelta un archivo o

URL de la imagen utilizada como entrada para la generación con ControlNet.

image_size predeterminado auto

Dimensiones de la imagen generada.

num_images predeterminado 1

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

Avanzado output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format predeterminado png

Formato de archivo de la imagen resultante.

acceleration predeterminado regular

Nivel de aceleración aplicado al procesamiento.

preprocess predeterminado none

Método de preprocesamiento aplicado a la imagen, o ningún preprocesamiento.

predeterminado 8

Cantidad de pasos de inferencia que se ejecutarán.

predeterminado 0.75

Intensidad del condicionamiento aplicado por ControlNet.

predeterminado 0

Punto inicial para el condicionamiento de ControlNet.

predeterminado 0.8

Punto final para el condicionamiento de ControlNet.

Seed para obtener imágenes reproducibles: un prompt y una seed idénticos producen una imagen idéntica cuando la versión del modelo no cambia.

POST /run/z-image/turbo/controlnet?wait=20 cotización → 0,013 $
# 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/z-image/turbo/controlnet?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",
    "image": "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 Z Image Turbo Controlnet

Genera imágenes a partir de un `prompt` mientras una imagen de control (`image_url`) dirige la estructura. `preprocess` puede extraer bordes canny, profundidad o pose, o usar none. `control_scale`, `control_start` y `control_end` ajustan la intensidad y el momento de aplicación del condicionamiento. Admite hasta 4 imágenes, 8 pasos y un `image_size` automático.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
Prompt que orienta la generación de imágenes.
image_sizeopcional
Tipoobject
Predeterminadoauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Dimensiones de la imagen generada.
num_inference_stepsopcional
Tipointeger
Predeterminado8
1 – 8
Cantidad de pasos de inferencia que se ejecutarán.
seedopcional
Tipointeger | null
Seed para obtener imágenes reproducibles: un prompt y una seed idénticos producen una imagen idéntica cuando la versión del modelo no cambia.
num_imagesopcional num_outputs
Tipointeger
Predeterminado1
1 – 4
Cantidad de imágenes solicitada para la generación.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
Comprobación de seguridad que devuelve imágenes negras en lugar de las imágenes marcadas como no seguras. Un valor true activa la comprobación; false la desactiva solo para cuentas autorizadas, mientras que las solicitudes sin autorización se comprueban siempre.
output_formatopcional
Tipoenum
Predeterminadopng
jpegpngwebp
Formato de archivo de la imagen resultante.
accelerationopcional
Tipoenum
Predeterminadoregular
noneregularhigh
Nivel de aceleración aplicado al procesamiento.
enable_prompt_expansionopcional
Tipoboolean
Predeterminadofalse
Controla si la expansión del prompt está habilitada.
image_urlobligatorio image
Tipourl · image
URL de la imagen utilizada como entrada para la generación con ControlNet.
control_scaleopcional
Tiponumber
Predeterminado0.75
0 – 1
Intensidad del condicionamiento aplicado por ControlNet.
control_startopcional
Tiponumber
Predeterminado0
0 – 1
Punto inicial para el condicionamiento de ControlNet.
control_endopcional
Tiponumber
Predeterminado0.8
0 – 1
Punto final para el condicionamiento de ControlNet.
preprocessopcional
Tipoenum
Predeterminadonone
nonecannydepthpose
Método de preprocesamiento aplicado a la imagen, o ningún preprocesamiento.
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": "z-image/turbo/controlnet",
  "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": 13,
    "usd": "0.013",
    "charged": 13,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "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, content_type, file_name, file_size, width, height}Información de los archivos de las imágenes generadas.
timings
objectInformación temporal del proceso de generación.
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: Edición de imágenes

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