Перейти к содержимому

SDXL ControlNet Union

Интеграция

ID модели sdxl-controlnet-union
# 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/sdxl-controlnet-union?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"
  }'

# 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"

Этот запрос: ≈0,014 $ 14 API-кредитов · ≈ 1,48 ₽ Запустить на этой странице

Получить API-ключ
Stability AI Текст в изображение #diffusion#controlnet#composition

SDXL для преобразования текста в изображение под управлением до шести контрольных изображений: openpose, карта глубины, teed, canny, normal, сегментация

Stability AI · Изображение

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно

Опишите изображение, которое хотите сгенерировать, как можно подробнее для получения лучших результатов.

image_size

Размеры выходных данных, автоматически определяемые по управляющему изображению, если размер не указан.

num_images по умолчанию 1

Количество изображений, запрошенных для генерации.

Расширенные negative_prompt · openpose_image_url · depth_image_url · teed_image_url · canny_image_url · normal_image_url · segmentation_image_url · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
по умолчанию

Негативный промпт с деталями изображения, которые нужно исключить, включая цвета, объекты, пейзаж или мелкие признаки. Например, усы, размытие или низкое разрешение.

Перетащите файл или

URL управляющего изображения.

Перетащите файл или

URL управляющего изображения.

Перетащите файл или

URL управляющего изображения.

Перетащите файл или

URL управляющего изображения.

Перетащите файл или

URL управляющего изображения.

Перетащите файл или

URL управляющего изображения.

safety_checker_version по умолчанию v1

Выбор между пользовательским средством проверки безопасности ViT (`v2`) и средством проверки CompVis (`v1`, по умолчанию).

format по умолчанию jpeg

Формат файла итогового изображения.

по умолчанию

Идентификатор запроса для сопоставления ответа с запросом, который его создал.

по умолчанию 0.5

Сила обусловливания, применяемого ControlNet.

по умолчанию 35

Количество выполняемых шагов инференса.

по умолчанию 7.5

Сила соответствия промпту при выборе изображения, выраженная через CFG (Classifier Free Guidance).

Сид для воспроизведения изображений в Stable Diffusion. Изображение можно точно воспроизвести при каждом запуске, если не менять версию модели, промпт и сид.

по умолчанию []

Веса LoRA, выбранные для использования и переданные в виде списка.

по умолчанию []

Эмбеддинги, выбранные для использования и переданные в виде списка.

POST /run/sdxl-controlnet-union?wait=20 стоимость → 0,014 $
# 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/sdxl-controlnet-union?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"
  }'

# 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"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О SDXL ControlNet Union

Генерирует изображения SDXL из `prompt` под управлением контрольных изображений, таких как openpose, карта глубины, teed, canny, normal или сегментация; для каждого доступен собственный переключатель preprocess. `controlnet_conditioning_scale` принимает значения от 0 до 1. Размер изображения можно определить по контрольному изображению. Поддерживаются LoRA, эмбеддинги, от 1 до 8 изображений и выходные данные jpeg или png.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Опишите изображение, которое хотите сгенерировать, как можно подробнее для получения лучших результатов.
controlnet_conditioning_scaleнеобязательно
Типnumber
По умолчанию0.5
0 – 1
Сила обусловливания, применяемого ControlNet.
negative_promptнеобязательно
Типstring
По умолчанию
Негативный промпт с деталями изображения, которые нужно исключить, включая цвета, объекты, пейзаж или мелкие признаки. Например, усы, размытие или низкое разрешение.
image_sizeнеобязательно
Типobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Размеры выходных данных, автоматически определяемые по управляющему изображению, если размер не указан.
num_inference_stepsнеобязательно
Типinteger
По умолчанию35
1 – 70
Количество выполняемых шагов инференса.
seedнеобязательно
Типinteger | null
Сид для воспроизведения изображений в Stable Diffusion. Изображение можно точно воспроизвести при каждом запуске, если не менять версию модели, промпт и сид.
guidance_scaleнеобязательно
Типnumber
По умолчанию7.5
0 – 20
Сила соответствия промпту при выборе изображения, выраженная через CFG (Classifier Free Guidance).
num_imagesнеобязательно num_outputs
Типinteger
По умолчанию1
1 – 8
Количество изображений, запрошенных для генерации.
lorasнеобязательно
Типobject[]
По умолчанию[]
Веса LoRA, выбранные для использования и переданные в виде списка.
loras[].forceнеобязательно
Типboolean
По умолчаниюfalse
Обязательно ли использование эмбеддинга: значение true делает его обязательным.
loras[].pathобязательно
Типstring
Источник весов LoRA: идентификатор модели HF, разрешающийся в веса safetensors, либо файл safetensors, указанный URL или путём.
loras[].scaleнеобязательно
Типnumber
По умолчанию1
0 – 1
Множитель, применяемый к весу LoRA перед объединением с базовой моделью.
embeddingsнеобязательно
Типobject[]
По умолчанию[]
Эмбеддинги, выбранные для использования и переданные в виде списка.
embeddings[].pathобязательно
Типstring
Веса эмбеддинга, указанные URL или путём к файлу.
embeddings[].tokensнеобязательно
Типstring[]
Список токенов эмбеддинга. Если он не указан, имена назначаются автоматически: каждый вектор в файле эмбеддинга получает токен из последовательности <s0>, <s1>, ... .
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Активация проверки безопасности; значение true включает проверку.
safety_checker_versionнеобязательно
Типenum
По умолчаниюv1
v1v2
Выбор между пользовательским средством проверки безопасности ViT (`v2`) и средством проверки CompVis (`v1`, по умолчанию).
expand_promptнеобязательно
Типboolean
По умолчаниюfalse
Расширение промпта дополнительными промптами, включаемое значением true.
formatнеобязательно
Типenum
По умолчаниюjpeg
jpegpng
Формат файла итогового изображения.
request_idнеобязательно
Типstring
По умолчанию
Идентификатор запроса для сопоставления ответа с запросом, который его создал.
openpose_image_urlнеобязательно
Типurl · image
URL управляющего изображения.
openpose_preprocessнеобязательно
Типboolean
По умолчаниюtrue
Управляет предварительной обработкой изображения openpose.
depth_image_urlнеобязательно
Типurl · image
URL управляющего изображения.
depth_preprocessнеобязательно
Типboolean
По умолчаниюtrue
Управляет предварительной обработкой изображения глубины.
teed_image_urlнеобязательно
Типurl · image
URL управляющего изображения.
teed_preprocessнеобязательно
Типboolean
По умолчаниюtrue
Управляет предварительной обработкой изображения teed.
canny_image_urlнеобязательно
Типurl · image
URL управляющего изображения.
canny_preprocessнеобязательно
Типboolean
По умолчаниюtrue
Управляет предварительной обработкой изображения canny.
normal_image_urlнеобязательно
Типurl · image
URL управляющего изображения.
normal_preprocessнеобязательно
Типboolean
По умолчаниюtrue
Управляет предварительной обработкой изображения нормалей.
segmentation_image_urlнеобязательно
Типurl · image
URL управляющего изображения.
segmentation_preprocessнеобязательно
Типboolean
По умолчаниюtrue
Управляет предварительной обработкой изображения сегментации.
обязательно Каноническое имя, также принимается

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union",
  "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": 14,
    "usd": "0.014",
    "charged": 14,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
images
array of object {url, width, height, content_type}Информация о файлах сгенерированных изображений.
timings
object
seed
integerСид генерации изображения, включая случайно выбранное значение, если во входных данных сид не указан; в противном случае повторяет переданное значение.
has_nsfw_concepts
array of booleanПоказывает, присутствуют ли в сгенерированных изображениях концепции NSFW.
prompt
stringПромпт, используемый при генерации изображения.

Другие модели: Текст в изображение

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/sdxl-controlnet-union.md. Все модели и руководства: https://doitong.com/developers/llms.txt