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

ControlNet SDXL · Image to Image

Интеграция

ID модели fast-sdxl-controlnet-canny/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/fast-sdxl-controlnet-canny/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",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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,015 $ 15 API-кредитов · ≈ 1,60 ₽ Запустить на этой странице

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

Преобразование изображения в изображение с ControlNet SDXL: стилизация исходника по структуре контрольного изображения

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

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

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

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

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

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

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

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

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

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

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

image_size

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

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

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

Расширенные negative_prompt · 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 · loras · embeddings
по умолчанию

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

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/fast-sdxl-controlnet-canny/image-to-image?wait=20 стоимость → 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/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",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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-ключ

О ControlNet SDXL · Image to Image

Принимает `prompt`, `control_image_url` для структуры и `image_url` как исходное изображение. `strength` (от 0.05 до 1, по умолчанию 0.95) определяет, насколько результат следует источнику. Дополнительно поддерживаются `preserve_aspect_ratio`, `crop_output`, LoRA, эмбеддинги и до 8 изображений за запрос.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Опишите изображение, которое хотите сгенерировать, как можно подробнее для получения лучших результатов.
control_image_urlобязательно
Типurl · image
URL управляющего изображения.
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.
обязательно Каноническое имя, также принимается

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

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fast-sdxl-controlnet-canny/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": 15,
    "usd": "0.015",
    "charged": 15,
    "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",
    "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"
  }
}
Ваши файлы — ваш выборКаждый 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/fast-sdxl-controlnet-canny/image-to-image.md. Все модели и руководства: https://doitong.com/developers/llms.txt