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

Boogu Image · Edit

Интеграция

ID модели boogu-image/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/boogu-image/edit?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Этот запрос: ≈0,08 $ 80 API-кредитов · ≈ 8,53 ₽ Запустить на этой странице

Получить API-ключ

Редактирование изображения по инструкции на основе входного изображения с раздельной настройкой силы текстового и визуального guidance

Open model · Изображение

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

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

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

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

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

Инструкции по преобразованию изображения на одном из поддерживаемых Boogu-Image языков: английском или китайском.

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

URL изображения, которое будет отредактировано.

image_size

Размеры отредактированного изображения; по умолчанию выбираются размеры, сохраняющие пропорции входных данных и не превышающие нативный предел модели 2K.

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

Количество создаваемых отредактированных изображений.

Расширенные negative_prompt · output_format · num_inference_steps · guidance_scale · image_guidance_scale · cfg_range_start · cfg_range_end · seed · enable_safety_checker
по умолчанию

Содержимое, исключаемое из отредактированного изображения с помощью classifier-free guidance. Пустое значение отключает негативное текстовое управление.

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

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

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

Количество выполняемых итераций удаления шума.

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

Сила текстового управления при редактировании: увеличение значения заставляет результат точнее следовать инструкции.

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

Сила управления эталонным изображением: большие значения лучше сохраняют входные данные, а при 1.0 CFG изображения отключается.

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

Начальная точка, заданная долей шага по времени, для применения CFG.

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

Конечная точка, заданная долей шага по времени, для применения CFG.

Seed для воспроизводимой генерации изображения: изображение можно точно воссоздать, повторно используя seed вместе с исходным промптом, входным изображением и версией модели.

POST /run/boogu-image/edit?wait=20 стоимость → 0,08 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/boogu-image/edit?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

О Boogu Image · Edit

Редактирует изображение по адресу `image_url` согласно текстовому `prompt` на английском или китайском. Если `image_size` не указан, выход сохраняет соотношение сторон входного изображения в пределах нативного лимита 2K. `guidance_scale` управляет соответствием промпту, а `image_guidance_scale` (от 1 до 8) при увеличении сильнее сохраняет исходное изображение. Возвращает от 1 до 4 отредактированных изображений в jpeg или png.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Инструкции по преобразованию изображения на одном из поддерживаемых Boogu-Image языков: английском или китайском.
image_urlобязательно image
Типurl · image
URL изображения, которое будет отредактировано.
negative_promptнеобязательно
Типstring
По умолчанию
Содержимое, исключаемое из отредактированного изображения с помощью classifier-free guidance. Пустое значение отключает негативное текстовое управление.
image_sizeнеобязательно
Типobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Размеры отредактированного изображения; по умолчанию выбираются размеры, сохраняющие пропорции входных данных и не превышающие нативный предел модели 2K.
num_inference_stepsнеобязательно
Типinteger
По умолчанию30
20 – 50
Количество выполняемых итераций удаления шума.
guidance_scaleнеобязательно
Типnumber
По умолчанию4
1 – 8
Сила текстового управления при редактировании: увеличение значения заставляет результат точнее следовать инструкции.
image_guidance_scaleнеобязательно
Типnumber
По умолчанию1
1 – 8
Сила управления эталонным изображением: большие значения лучше сохраняют входные данные, а при 1.0 CFG изображения отключается.
cfg_range_startнеобязательно
Типnumber
По умолчанию0
0 – 1
Начальная точка, заданная долей шага по времени, для применения CFG.
cfg_range_endнеобязательно
Типnumber
По умолчанию1
0 – 1
Конечная точка, заданная долей шага по времени, для применения CFG.
num_imagesнеобязательно num_outputs
Типinteger
По умолчанию1
1 – 4
Количество создаваемых отредактированных изображений.
seedнеобязательно
Типinteger | null
Seed для воспроизводимой генерации изображения: изображение можно точно воссоздать, повторно используя seed вместе с исходным промптом, входным изображением и версией модели.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Управление проверкой безопасности входных и сгенерированных изображений; отключать проверку могут только авторизованные аккаунты, а все остальные запросы проверяются независимо от этой настройки. Значение true включает проверку, а небезопасные изображения заменяются чёрными.
output_formatнеобязательно
Типenum
По умолчаниюjpeg
jpegpng
Формат файла итогового изображения.
обязательно Каноническое имя, также принимается

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

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "boogu-image/edit",
  "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": 80,
    "usd": "0.08",
    "charged": 80,
    "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",
        "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/boogu-image/edit.md. Все модели и руководства: https://doitong.com/developers/llms.txt