Введение
Обязательное исходное видео без склеек, не длиннее 15 секунд. Его длительность определяет оплату, а звук сохраняется. change используется по умолчанию и заменяет цель. background сохраняет её и меняет остальное; people оставляет людей.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Издатель | ComfyUI |
| Эндпоинты | video-edit |
| Входные данные | Видео, цель, текст и/или один референс |
| Исходный ролик | Одна съёмка, максимум 15 секунд |
| Разрешение | 480p / 540p / стандарт 768p / 1080p |
| Звук | Звуковая дорожка источника остаётся |
| Выполнение | Асинхронная задача; расчёт по входной длительности |
Ключевые возможности и особенности
Разделяйте цвет волос и стрижку
В тесте в оранжерее запрашивались короткие платиновые волосы. Цвет изменился, но значительная часть исходной длины и завитков сохранилась. Оценивайте признаки отдельно: удачное окрашивание не подтверждает выполнение заказанной стрижки.
Посмотрите на соседа цели
В тесте в винном погребе целью служит blouse, а заменой — белая льняная рубашка. Сравните одежду женщины вместе с мужчиной рядом и поднятыми бокалами. Так проще проверить область изменения, не предполагая полного совпадения всех пикселей вне цели.
При смене места назовите то, что остаётся
В режиме background защищаемая цель — people, а prompt описывает ночную террасу на крыше. В примере погреба пара и бокалы остаются, а окружение меняется на городские огни. Проверьте контуры людей и просветы у рук, где сходятся старое и новое окружение.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Обязательное исходное видео без склеек, не длиннее 15 секунд. Его длительность определяет оплату, а звук сохраняется. Не менее 1 символов |
edit_target | Да | Краткое название видимого элемента, например hair, jacket или car. Несколько целей разделяйте запятыми; в background они обозначают сохраняемые элементы. Не менее 1 символов · Не более 120 символов |
edit_mode | Нет | change используется по умолчанию и заменяет цель. background сохраняет её и меняет остальное; people оставляет людей. |
prompt | Нет | Опишите новый вид или новое место для background. Нужно это поле либо |
reference_image_url | Нет | Необязательный образец одежды, причёски, товара или места. Предпочтителен отдельный предмет с текстом; фото целого человека в пробе не воспроизвело нужный костюм. Не менее 1 символов |
resolution | Нет | 480p, 540p, стандартное 768p или 1080p. С повышением уровня растёт ставка; горизонтальные размеры в тестах: 864×480, 960×544, 1376×768, 1920×1056. |
seed | Нет | Необязательное целое число от 0 до 2147483647. Один источник случайности облегчает сравнение отдельной настройки, не обещая покадрового повторения. |
Стоимость
Правка объектов оплачивается по округлённым вверх секундам входа, минимум за 3 секунды. Тариф задаётся разрешением, без надбавки за картинку. Неуспешные задачи не списывают деньги, а источники длиннее 15 секунд отклоняются до оплаты.
| Спецификация | Стоимость |
|---|---|
| $0.105 / секунду |
| $0.119 / секунду |
| $0.14 / секунду |
| $0.28 / секунду |
Сценарии использования
Варианты костюма
Сравните кожаную куртку и льняную рубашку на разрешённой съёмке взрослого.
Проба цвета волос
Попробуйте платиновый оттенок и проверьте сохранность длины и кудрей.
Другое место для тоста
Сохраните людей и бокалы, перенеся винный погреб на ночную крышу.
Товарные концепции
Протестируйте отдельный референс товара с описанием и проверьте замену до рекламного размещения.
Руководство по промптам и практические советы
Уточните право на редактирование
Проверьте разрешения на лица, фотографии и видео; каждому изображённому человеку должно исполниться 18 лет.
Выберите цель и режим
В
edit_targetкратко назовите видимый элемент. change заменяет его, background оставляет и меняет всё вокруг.Опишите желаемый результат
Задайте prompt,
reference_image_urlили оба поля. Для background опишите новое место; для одежды лучше отдельный предмет с точным текстом.Посмотрите пробную версию
После асинхронной обработки проверьте объект, соседние детали и звук.
Введение
Обязательное исходное видео без склеек, не длиннее 15 секунд. Его длительность определяет оплату, а звук сохраняется. change используется по умолчанию и заменяет цель. background сохраняет её и меняет остальное; people оставляет людей.
Порядок работы
Вызовите openjutsu/object-swap/video-edit с публичными входными данными и сохраните идентификатор. Опрашивайте задачу до конечного состояния; при успехе заберите изменённый ролик из файлов результата и просмотрите перед монтажом.
Параметры
video_url: Обязательное исходное видео без склеек, не длиннее 15 секунд. Его длительность определяет оплату, а звук сохраняется.edit_target: Краткое название видимого элемента, например hair, jacket или car. Несколько целей разделяйте запятыми; в background они обозначают сохраняемые элементы.edit_mode: change используется по умолчанию и заменяет цель. background сохраняет её и меняет остальное; people оставляет людей.- prompt: Опишите новый вид или новое место для background. Нужно это поле либо
reference_image_url; можно передать оба. reference_image_url: Необязательный образец одежды, причёски, товара или места. Предпочтителен отдельный предмет с текстом; фото целого человека в пробе не воспроизвело нужный костюм.- resolution: 480p, 540p, стандартное 768p или 1080p. С повышением уровня растёт ставка; горизонтальные размеры в тестах: 864×480, 960×544, 1376×768, 1920×1056.
- seed: Необязательное целое число от 0 до 2147483647. Один источник случайности облегчает сравнение отдельной настройки, не обещая покадрового повторения.
Оплата
Правка объектов оплачивается по округлённым вверх секундам входа, минимум за 3 секунды. Тариф задаётся разрешением, без надбавки за картинку. Неуспешные задачи не списывают деньги, а источники длиннее 15 секунд отклоняются до оплаты.
Советы
Отделяйте название существующего предмета от описания замены. Полезны отдельный референс и текст. Если при другой длине источника возникает общая ошибка, укоротите источник до точного целого числа секунд и повторите.
Ограничения
- Даже редактирование предметов требует согласия видимых взрослых. Допустимы ваше лицо или разрешённое чужое; фото знаменитостей, знакомых и из сети не становятся разрешёнными от доступности. Подмена личности и обман запрещены.
- Принимается одна непрерывная съёмка не длиннее 15 секунд. Последовательность из нескольких планов нужно разделить перед отправкой.
- В тесте волосы стали платиновыми, но остались прежней длины и завивки вопреки запросу короткой стрижки. Цвет может меняться легче формы.
- Единственная проба с фото целого человека не повторила нужную одежду. Рекомендуется изображение отдельного предмета с понятным текстом, но это не проверенная гарантия результата.
- Для редактирования объектов платформа автоматически удаляет примерно 4 кадра в начале источника длиной около 5,17 секунды (5,13–5,20 секунды), оставляя для обработки ровно 5 секунд. Ручная обрезка не требуется: плата взимается за 5 секунд, а лишняя секунда из первоначального резерва на 6 секунд освобождается. Если при другой длине источника возникает общая ошибка, обрежьте его ровно до целых секунд и отправьте повторно; неуспешное редактирование объектов не оплачивается.
Загружайте только своё лицо или лица с разрешением и проверяйте, что всем людям во всех материалах исполнилось 18 лет; публичное изображение не равно согласию. Запрещены выдача себя за другого и вводящие в заблуждение применения. На сайте перед первым запуском обязательно отметить принятие правил, а использование API означает согласие с теми же правилами. Нарушающий контент удаляется, аккаунт может быть заблокирован.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "comfyui/openjutsu-object-swap/video-edit",
"input": {
"edit_mode": "change",
"edit_target": "example",
"resolution": "768p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.




