Введение
Обязательный MP4 без склеек, до 15 секунд. Все заменяемые люди должны быть видны с первого кадра. Обязательный массив из 1–4 фото, иллюстраций или 3D-рендеров, по изображению на персонажа. Предпочтителен полный рост.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Издатель | ComfyUI |
| Эндпоинты | video-edit |
| Входные данные | MP4 и 1–4 изображения, описание ролей необязательно |
| Исходный ролик | Один непрерывный план, до 15 секунд |
| Разрешение | 480p / 540p / 768p по умолчанию / 1080p |
| Звук | Исходный звук сохраняется |
| Выполнение | Асинхронно, оплата за секунды источника |
Ключевые возможности и особенности
Используйте порядок изображений для ролей
В тесте с двумя велосипедистами первая референсная картинка назначена человеку в синей рубашке слева, вторая — человеку в красной справа. Запишите описания отдельными строками prompt в порядке картинок. Проверьте каждое назначение: изменившаяся группа ещё не доказывает, что обе роли распределены верно.
Оценивайте не только лицо, но и силуэт
В студийном тесте снятая взрослая танцовщица заменена рисованной рыжеволосой героиней. Волосы и костюм меняются по всему телу, а исходная поза задаёт основу движения. Проверьте рукава, талию и волосы в движении: одного удачного лица недостаточно для оценки всего образа.
Проверяйте конец короткого дубля
Этот кадр снова показывает тест с двумя велосипедистами, теперь на третьей секунде. Сравните велосипеды, расстояния и улицу вместе с новыми персонажами, затем досмотрите конец: из этого пятисекундного исходника получилось около четырёх с половиной секунд. Планируйте монтаж по фактической длине результата, не растягивая просмотр ради видимого совпадения длительностей.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Обязательный MP4 без склеек, до 15 секунд. Все заменяемые люди должны быть видны с первого кадра. Не менее 1 символов |
reference_image_urls | Да | Обязательный массив из 1–4 фото, иллюстраций или 3D-рендеров, по изображению на персонажа. Предпочтителен полный рост. Не менее 1 элементов · Не более 4 элементов |
prompt | Нет | Необязательно: по человеку на строку в порядке изображений. Без текста одно изображение выбирает главного человека; несколько следуют появлению, при совпадении — слева направо. Не более 600 символов |
resolution | Нет | 480p, 540p, 768p или 1080p; стандарт — 768p. Выше разрешение — выше ставка за секунду. |
seed | Нет | Необязательное целое число 0–2147483647. Общий источник случайности помогает сравнивать по одному изменению за раз, но не гарантирует совпадения кадров. |
Стоимость
Для замены персонажей секунды источника округляются вверх, минимум до 3. Ставка зависит от разрешения, изображения не оплачиваются отдельно, неудачные задачи бесплатны. Ролики свыше 15 секунд отклоняются до начисления платы.
| Спецификация | Стоимость |
|---|---|
| $0.105 / секунду |
| $0.119 / секунду |
| $0.14 / секунду |
| $0.28 / секунду |
Сценарии использования
Подбор персонажей для короткометражки
Попробуйте другой образ на основе разрешённой актёрской игры.
Замена нескольких участников
Назначьте двум велосипедистам разные изображения, сохранив велосипеды и улицу.
Рисованный герой в движении
Используйте рисунок или 3D-персонажа для движения взрослого исполнителя.
Варианты для рекламы
Сравните вымышленных героев на одной съёмке для рекламы и соцсетей.
Руководство по промптам и практические советы
Проверьте разрешения
Убедитесь в праве использовать видео и внешность каждого человека; всем должно быть не менее 18 лет. Используйте себя, актёров с письменным согласием или созданных вами вымышленных персонажей.
Сопоставьте изображения
Подготовьте 1–4 изображения, желательно в полный рост, и опишите по одному человеку в строке в том же порядке.
Оцените новый состав
Запустите задачу и перед публикацией проверьте внешность, одежду, движения и длительность.
Введение
Обязательный MP4 без склеек, до 15 секунд. Все заменяемые люди должны быть видны с первого кадра. Обязательный массив из 1–4 фото, иллюстраций или 3D-рендеров, по изображению на персонажа. Предпочтителен полный рост.
Порядок работы
Отправьте публичные поля в openjutsu/character-swap/video-edit и сохраните ID задачи. Опрашивайте статус до успеха или ошибки, затем получите видео из файлов результата успешной задачи. Замена персонажей в тестах занимала примерно 1–4 минуты.
Параметры
video_url: Обязательный MP4 без склеек, до 15 секунд. Все заменяемые люди должны быть видны с первого кадра.reference_image_urls: Обязательный массив из 1–4 фото, иллюстраций или 3D-рендеров, по изображению на персонажа. Предпочтителен полный рост.- prompt: Необязательно: по человеку на строку в порядке изображений. Без текста одно изображение выбирает главного человека; несколько следуют появлению, при совпадении — слева направо. Референсы без цели пропускаются, остальные люди не меняются.
- resolution: 480p, 540p, 768p или 1080p; стандарт — 768p. Выше разрешение — выше ставка за секунду. Измеренные горизонтальные размеры: 864×480, 960×544, 1376×768, 1920×1056.
- seed: Необязательное целое число 0–2147483647. Общий источник случайности помогает сравнивать по одному изменению за раз, но не гарантирует совпадения кадров.
Оплата
Для замены персонажей секунды источника округляются вверх, минимум до 3. Ставка зависит от разрешения, изображения не оплачиваются отдельно, неудачные задачи бесплатны. Ролики свыше 15 секунд отклоняются до начисления платы.
Советы
Используйте полный рост и явные строки назначения ролей. При общей ошибке с источником другой длины обрежьте до целых секунд и попробуйте снова. Проверяйте не только лицо, но и одежду.
Ограничения
- Допустимы только ваше лицо или лица согласившихся взрослых. Знаменитости, знакомые и фотографии из интернета тоже требуют разрешения. Нельзя помещать реального человека в сцену, на которую он не соглашался.
- Источник — непрерывный MP4 длительностью не более 15 секунд; заменяемые люди должны быть видны в первом кадре. Монтаж со сменой планов не поддерживается.
- Одежда не обязана точно повторять референс: в тесте по фото взрослой женщины получилось длинное белое платье вместо одежды с изображения.
- При замене персонажей источники длиной около 5,17 секунды (5,13–5,20 секунды) автоматически обрезаются перед обработкой ровно до 5 секунд с удалением примерно 4 начальных кадров. Вам не нужно обрезать их самостоятельно; оплачиваются 5 секунд, а сумма за дополнительную секунду, зарезервированную из расчёта 6 секунд, освобождается. Если источник другой длины завершится общей ошибкой, обрежьте его до точного целого числа секунд и повторите попытку; неудачные задачи замены персонажей бесплатны.
- В тестах из 5 секунд получалось около 4,5 секунды, а 8 секунд оставались 8. Проверьте хронометраж перед монтажом.
Используйте только своё лицо или лица людей с их согласием и материалы, где всем не менее 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-character-swap/video-edit",
"input": {
"reference_image_urls": [
"https://example.com/reference.png"
],
"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.




