Генератор ИИ «изображение в изображение» без цензуры: практическое руководство по API редактирования

Вы хотите изменить через код что-то одно на фотографии: свет, фон, одежду или надпись. Нужен редактор, который не откажет и не ослабит инструкцию незаметно. Здесь объясняем, какой эндпоинт вызвать, сколько он стоит, что принимает, как попробовать правку в Playground, затем из кода или через Agent, и что делать при сбое.

Коротко: вызов «изображение в изображение» — это задача на эндпоинте, ID модели которого оканчивается на /edit: вы отправляете промпт и исходное изображение и получаете отредактированный файл. Для одной фотографии и одной инструкции начните с Qwen Image Edit Spicy: $0.038 за правку, один источник, без маски и регулятора силы. Для нескольких источников используйте Qwen Image 3.0, Seedream 5.0 Pro или Wan 2.7. Для маски — Qwen Image 2.1 или FLUX.1 Dev LoRA; strength есть только у FLUX.1 Dev LoRA и Z-Image Turbo LoRA.

Приведённые цены и ограничения взяты из актуального каталога и документации; для каждой цены получен бесплатный расчёт стоимости.

Что означает «без цензуры» для редактирования

«Без цензуры» — метка каталога для модели, заявляющей об отсутствии фильтра контента: SpicyAPI не добавляет проверку содержимого на уровне платформы, а результат определяет модель. Это не обещание выполнить любую инструкцию. Предусмотрите два исхода:

• Отказ завершает задачу со статусом failed и errorCode: "content_rejected". Зарезервированная сумма на балансе полностью освобождается.
• Смягчённый результат — готовое изображение мягче запрошенного. Задача успешна и оплачивается; в ответе нет признака смягчения. Обнаружить его можно лишь при просмотре изображения.

Некоторые ограничения действуют для всех моделей: нельзя создавать сексуализированные изображения несовершеннолетних в любом стиле, интимные или сексуализированные изображения узнаваемого реального человека без его документально подтверждённого согласия (включая замену лица и перенос внешности), выдавать себя за другого человека или делать что-либо незаконное в месте вашей деятельности. Второе правило легко нарушить при редактировании: источником часто служит реальная фотография. Согласно политике допустимого использования, публичная фотография, известность или прежние отношения не являются согласием. Материалы с неясным возрастом подпадают под правило о несовершеннолетних; нельзя загружать частные материалы, которые вы не вправе обрабатывать.

SpicyAPI не проверяет каждый запрос. Если ваши пользователи загружают фотографии, обязанности лежат на вас: подтверждение возраста, заявление о согласии при загрузке с сохранением вместе с ID задачи, отказ от источников с неясным возрастом, блокировка правок узнаваемых реальных людей без подтверждённого согласия и возможность пожаловаться на контент. Это не юридическая консультация.

Сервис недоступен в материковом Китае, России, Беларуси, на Кубе, в Иране, Северной Корее и Сирии; согласно условиям, также в Великобритании, Гонконге, Макао, Саудовской Аравии, ОАЭ, Катаре, Кувейте, Бахрейне, Омане, Пакистане, Бангладеш, Афганистане, Индонезии, Малайзии и Брунее. Политика контента и использования указывает, что список может расширяться. Замена лица и головы — отдельные эндпоинты со своим процессом, описанным в рабочем процессе API замены лица с ИИ.

Выберите эндпоинт редактирования

Эндпоинты отличаются числом источников, дополнительными настройками и формой результата:

Цены — расчёт для запроса на одно изображение. Seedream 5.0 Pro стоит вдвое дороже на уровне 2k по умолчанию, чем на 1k, а Qwen Image 3.0 добавляет плату за источник. Уровни Qwen Image 2.1 не дорожают последовательно (1.5k дороже 2k, а 2k имеет фиксированную цену независимо от числа источников). Поэтому до планирования бюджета рассчитайте точное тело запроса.

В каталоге есть и другие редакторы с меткой без цензуры, например Seedream 5.0 Flash, Qwen Image 3.0 Pro и Wan 2.7 Pro. Эндпоинты редактирования GPT Image 2 и 2.5 и Nano Banana имеют метку Filtered, поэтому не подходят, когда нужен результат без цензуры.

Одна фотография, одна правка. Используйте Qwen Image Edit Spicy. Весь запрос — это image_url, prompt и необязательный seed; инструкция является единственным управлением, поэтому фраза о том, что сохранить, служит и настройкой сохранения. Согласно обзору, типичная правка занимает около 21 секунды. Qwen Image 2 устроен аналогично, немного дешевле, с одним источником и промптом до 800 символов.

Несколько источников в одной правке. Лицо из одной фотографии, одежда из другой, комната из третьей: Qwen Image 3.0 (три источника), Seedream 5.0 Pro (десять) или Wan 2.7 (девять). Промпт должен объяснять, что даёт каждый источник. Seedream 5.0 Pro по умолчанию ориентируется на форму первого, Wan 2.7 — последнего, а Qwen возвращает квадрат: портрет, отправленный в Qwen Image 3.0 без aspect_ratio, вернётся в 1:1.

Локальные правки с маской или регулировкой силы. Qwen Image 2.1 и FLUX.1 Dev LoRA принимают маску как mask_url: чёрно-белое изображение размера источника, где белое перерисовывается, а чёрное сохраняется. strength (от 0 до 1, по умолчанию 0.8, степень отклонения от источника) есть у FLUX.1 Dev LoRA и эндпоинта редактирования Z-Image Turbo LoRA. Wan 2.7 отмечает области иначе: до двух прямоугольников в пикселях на изображение в bounding_boxes.

Результаты по контенту. В публичных отчётах за сентябрь 2026 каждый редактор прошёл пять уровней контента (L1 самый мягкий, L5 самый сильный), обычно по три запуска на уровень.

FLUX.1 Dev LoRA — самый дешёвый путь с маской и strength, но публичный отчёт касается текста в изображение, где сильные уровни были смягчены. Прежде чем выбирать его для всей работы, попробуйте свой уровень контента в одной правке.

Подробности есть в обзорах моделей, например Seedream 5.0 Pro; тест Qwen Image Edit без цензуры показывает пары до и после для редакторов Qwen.

Локально или в облаке? При GPU с минимум 8 GB VRAM и массовых правках локальная модель в ComfyUI (Qwen Image Edit или FLUX.2 Klein) — реальный вариант. Облачный сервис удобен, если вы не хотите обслуживать GPU, вызываете редактор из приложения или предпочитаете оплату за изображение: при $0.018–$0.072 за изображение сто правок стоят $1.80–$7.20 до повторных попыток.

Сначала попробуйте Playground

Быстрее всего увидеть, что редактор делает с фотографией, можно в Playground на странице модели, без кода и работы с ключами.

1. Откройте страницу Qwen Image Edit Spicy, останьтесь на вкладке Playground, в представлении Form. Для запуска войдите в аккаунт с пополненным балансом.
2. В Input image перетащите файл (JPG, PNG, WEBP или GIF, до 10 MB) либо используйте Asset URL и Add URL для прямой ссылки на файл.
3. В Prompt сначала укажите, что сохранить, затем одну правку (примеры формулировок — в следующем разделе).
4. При желании задайте Seed. Повторное использование с тем же изображением и инструкцией позволяет сравнить две формулировки.
5. Нажмите Run model и сначала посмотрите изображение в Output: смягчённый результат оплачивается как любой другой.

У других редакторов свои поля в той же форме: например, дополнительные источники или маска у Qwen Image 2.1. Представление JSON рядом с Form показывает точное тело запроса, а соседние вкладки кода (JavaScript, Python, cURL и другие) — тот же вызов. Рабочую конфигурацию отсюда можно перенести в проект.

Затем запустите из кода

Установите Python SDK (pip install spicyapi), задайте SPICY_API_KEY в окружении и выполните одну правку. Скрипт загружает фото, показывает цену и ждёт вашего согласия до создания задачи:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment
MODEL = "alibaba/qwen-image-spicy-edit/edit"

source = client.upload_file("photo.jpg")  # or put a public HTTPS link in image_url
body = {
    "image_url": source["uri"],
    "prompt": "Keep the person, pose, framing and room exactly as they are. "
              "Change only the light to warm late-afternoon sun from the window on the left.",
}

quote = client.quote_task(model=MODEL, input_data=body)
print("Estimated", quote["estimatedCost"], "maximum", quote["maxCharge"])
if input("Create the task? [y/N] ").strip().lower() != "y":
    raise SystemExit

task = client.create_task(
    model=MODEL,
    input_data=body,
    idempotency_key=str(uuid.uuid4()),
    quote_id=quote["quoteId"],
    expected_cost=quote["estimatedCost"],
)
print("Resume task:", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise SystemExit(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(a.get("pending") or a.get("unavailable") or not a.get("url") for a in assets):
    raise RuntimeError(f"Task {task['taskId']} has no ready output; check this task before a new run")
print(assets[0]["url"])  # copy the image to your own storage now

Справочник Python SDK и руководство по задачам объясняют всё сверх этого вызова; сервис, которому нужен обратный вызов вместо ожидания, может использовать вебхуки.

Или поручите запуск инструменту Agent

Если правки выполняет ассистент, все три официальных инструмента показывают цену и спрашивают перед платным вызовом.

• CLI. Загрузите фото, поместите полученный адрес spicy:// и промпт в input.json как image_url и prompt, затем:

``bash spicyapi files upload photo.jpg spicyapi tasks create --model alibaba/qwen-image-spicy-edit/edit --input-file input.json --wait ``

См. документацию CLI; npx @spicyapi/cli работает без установки.

• MCP-сервер. Добавьте MCP-сервер в ассистент, затем попросите: "Edit /path/to/photo.jpg with Qwen Image Edit Spicy: keep the person, pose and room, change only the light to warm late-afternoon sun." Он загрузит через spicyapi_upload_file, вызовет spicyapi_task_create, который остановится для подтверждения цены, затем spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill устанавливает Agent Skill: ассистент для программирования читает актуальную схему модели вместо угадывания полей.

Что можно отправить и сколько это стоит

Передать исходное изображение задаче можно тремя способами:

• Публичный HTTPS URL, без загрузки. Он должен возвращать сам файл без авторизации; страница общего доступа облачного диска или альбома — это веб-страница, и её отклонят с 400.
• Небольшое встроенное изображение, записанное как data:image/png;base64,... в том же поле. Это должен быть JPEG, PNG, WebP или GIF, максимум 1 MiB после декодирования и 8192 пикселя по стороне.
• Загрузка для больших или частных файлов: JPEG, PNG, WebP или GIF до 10 MiB. Загрузка бесплатна; оплачивается только задача с файлом. Возвращается URI spicy://, действующий один день.

Qwen Image 2 принимает только JPEG, PNG и WebP. Поля отличаются: Qwen Image Edit Spicy и FLUX.1 Dev LoRA используют строку image_url, остальные — массив image_urls. Эндпоинт отклоняет отсутствующее в схеме поле, а не игнорирует его.

Стоимость зависит от уровня разрешения, числа источников и, у Wan 2.7, num_outputs; цена перед подтверждением рассчитана на ваш точный запрос. См. расчёт стоимости и руководство по медиа.

Другие эндпоинты: меняется только ввод

Модели с массивом используют image_urls, а для нескольких источников промпт распределяет роли. Используйте тот же код с ID модели и телом ниже:

{
  "model": "alibaba/qwen-image-3.0/edit",
  "input": {
    "prompt": "Use the person from the first image and the jacket from the second. Keep her face, hair and pose from the first image. Change nothing else.",
    "image_urls": ["spicy://f/fil_...", "spicy://f/fil_..."],
    "aspect_ratio": "3:4",
    "resolution": "2k"
  }
}

Правка с маской в FLUX.1 Dev LoRA добавляет маску и силу в тело с одним источником:

{
  "model": "black-forest-labs/flux-1-dev-lora/edit",
  "input": {
    "prompt": "A black satin jacket with a high collar, same light as the rest of the photo.",
    "image_url": "spicy://f/fil_...",
    "mask_url": "spicy://f/fil_...",
    "strength": 0.9,
    "seed": 7
  }
}

Меньшее strength даёт результат ближе к оригиналу; по умолчанию 0.8. Копируйте значения из актуальной схемы на странице модели; руководство по генерации изображений объясняет различия эндпоинтов.

Пишите инструкцию: сначала что сохранить, затем что изменить

Эндпоинт перерисовывает то, что вы не зафиксировали: сначала скажите, что должно остаться идентичным, затем укажите одну правку. Перечисление большего числа сохраняемых элементов не стоит дороже. В Qwen Image 3.0 и 2.1 задайте enable_prompt_expansion как false для точного выполнения. По умолчанию функция включена и превращает промпт в более полное описание сцены, что может ослабить фразу о сохранении.

• Только свет: “Keep the person, pose, framing and room exactly as they are. Change only the light to warm late-afternoon sun from the window on the left. Keep the colour grade and film grain.”
• Только фон: “Keep the subject, outfit and crop. Replace the studio wall with dark theatre curtains. Add no logos or text.”
• Несколько источников: “Use the person from the first image, the jacket from the second and the street from the third. Keep her face and pose from the first image. Change nothing else.”

Меняйте одно за проход; совмещение смены стиля и правки текста приводит к дрейфу идентичности. Если результат не соответствует ожиданиям:

Если произошёл сбой

Это ошибки, специфичные для редактирования; выбирайте ветку по числовому code или errorCode задачи, а не по тексту сообщения.

Ошибки баланса, таймаута и прочие общие ошибки описаны в справочнике ошибок.

Что происходит с файлами

Загруженные фото хранятся один день, результаты — до 14 дней. Копируйте нужный результат в собственное хранилище сразу после успешного завершения. Если фото должно оставаться меньше, документация по хранению объясняет сокращение срока или уничтожение медиа и промпта завершённой задачи. См. также временные загрузки и постоянную доставку медиа и стартовое руководство по API изображений и видео.

Частые вопросы

Есть ли API «изображение в изображение» без цензуры с настройкой силы?

Да: FLUX.1 Dev LoRA (strength от 0 до 1, по умолчанию 0.8, с необязательной маской) и эндпоинт редактирования Z-Image Turbo LoRA. В остальных управление задаётся инструкцией, а отправка strength возвращает 400 strength: is not a supported field.

Нужно ли загружать фотографию?

Нет. Подойдёт публичная HTTPS-ссылка или встроенное изображение до 1 MiB; загружайте файл, если он больше или частный.

Стоит ли денег отказ или неудачная правка?

Обычно нет: неудачная задача полностью освобождает резерв, а ошибка создания ничего не списывает. Смягчённый результат — готовое изображение, и он оплачивается.

Сохранит ли правка лицо и позу?

Гарантии нет. Укажите, что сохранить, меняйте одно за проход и по возможности используйте один источник. Seedream 5.0 Pro сохранял человека при смене света и одежды, но менее точно размещал лицо при переносе человека в новую сцену со второй фотографии. Qwen Image 2 чисто выполнял простые правки, но перестраивал часть мебели при сложных.

Можно ли редактировать фото реального человека?

Только с его документально подтверждённым согласием; без него — никогда в сексуализированном виде. Это касается всех моделей; храните запись согласия в своей системе.

С какого эндпоинта начать?

Qwen Image Edit Spicy для одной фотографии и одной правки. Меняйте только при необходимости нескольких источников, маски или strength. Сначала выполните одну правку и посмотрите изображение, прежде чем менять эндпоинт.

Что дальше

Выполните одну правку в Playground на безобидной тестовой фотографии и прочитайте цену до подтверждения. Затем выберите оплачиваемый уровень разрешения и решите, использовать ли в продакшене вебхук вместо ожидания.

Подробности о промптах редактора Spicy — в процессе сохранения источника Qwen Image Edit Spicy. Чтобы сравнить редакторы существующих изображений не только через API, см. лучшие редакторы изображений ИИ без цензуры. Каталог API изображений без цензуры перечисляет все вызываемые модели с меткой контента и актуальной ценой.