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

SDXL ControlNet Union · Image to Image

Интеграция

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

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

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

SDXL image-to-image с управлением несколькими ControlNet по изображениям позы, глубины, контуров, нормалей или сегментации

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

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

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

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

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

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

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

•обязательно image_url
Перетащите файл или

Начальное изображение для генерации, переданное по URL.

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 · strength · seed · enable_safety_checker · expand_prompt · preserve_aspect_ratio · crop_output · 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).

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

Степень сходства между сгенерированным и исходным изображениями.

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

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

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

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

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

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

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

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

О SDXL ControlNet Union · Image to Image

Преобразует исходное изображение с помощью базы SDXL под управлением промпта и необязательных контрольных изображений для openpose, карта глубины, teed, canny, normal и сегментация. Для каждого контрольного входного параметра есть собственный переключатель preprocess. `strength` принимает значения от 0.05 до 1, `num_inference_steps` — от 1 до 70; за один вызов можно вернуть до 8 изображений. Можно передать LoRA и эмбеддинги; выходные данные — jpeg или png.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Опишите изображение, которое хотите сгенерировать, как можно подробнее для получения лучших результатов.
controlnet_conditioning_scaleнеобязательно
Типnumber
По умолчанию0.5
0 – 1
Сила обусловливания, применяемого ControlNet.
image_urlобязательно image
Типurl · image
Начальное изображение для генерации, переданное по URL.
negative_promptнеобязательно
Типstring
По умолчанию
Негативный промпт с указанием нежелательных деталей изображения. Он может исключать цвета, объекты, пейзаж или мелкие признаки и качества, например усы, размытие или низкое разрешение.
image_sizeнеобязательно
Типobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Размеры выходных данных, автоматически определяемые по управляющему изображению, если размер не указан.
num_inference_stepsнеобязательно
Типinteger
По умолчанию35
1 – 70
Количество выполняемых шагов инференса.
guidance_scaleнеобязательно
Типnumber
По умолчанию7.5
0 – 20
Сила соответствия промпту при выборе изображения, выраженная через CFG (Classifier Free Guidance).
strengthнеобязательно
Типnumber
По умолчанию0.95
0,05 – 1
Степень сходства между сгенерированным и исходным изображениями.
seedнеобязательно
Типinteger | null
Сид для воспроизведения изображений в Stable Diffusion. Изображение можно точно воспроизвести при каждом запуске, если не менять версию модели, промпт и сид.
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
По умолчанию
Идентификатор запроса для сопоставления ответа с запросом, который его создал.
preserve_aspect_ratioнеобязательно
Типboolean
По умолчаниюfalse
Установите значение true, чтобы сохранить соотношение сторон сгенерированного изображения, даже если его размер превышает лимит. Чтобы получить правильные пропорции за счёт обрезки после генерации, установите crop_output в True. Значения ширины или высоты, не кратные 32, всё равно округляются до ближайшего кратного 32; по умолчанию это изменение размера не сохраняет соотношение сторон.
crop_outputнеобязательно
Типboolean
По умолчаниюfalse
Обрезать выходные данные до правильного соотношения сторон, если установлено значение true.
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/image-to-image",
  "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": 48,
    "usd": "0.048",
    "charged": 48,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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/image-to-image.md. Все модели и руководства: https://doitong.com/developers/llms.txt