Справочник рабочего API
API DeepSwapAI для AI face swap
Подключите замену лиц на фото, пакетах, групповых фото, видео и GIF через единый рабочий интерфейс. Изучите контракт, единицы оплаты, состояния задач и границы; полные поля и ответы доступны в английском справочнике API.
Один контракт, пять рабочих процессов
HTTPS, multipart-загрузка и состояния задач JSON
Все опубликованные маршруты генерации используют Bearer API-ключ, возвращают taskId и проверяют состояние через GET того же маршрута.
Короткий ответ
Один API-аккаунт для пяти типов входных данных
Фото, пакетные фото, сопоставление лиц на групповом фото, видео и GIF используют один рабочий домен и жизненный цикл задачи. До запроса проверьте формат, размер, длительность, число целей и кредиты; после отправки сохраните taskId и опрашивайте соответствующий GET-маршрут.
Опубликованный контракт
Маршруты, единицы оплаты и основные границы
| Процесс | POST-маршрут | Единица | Основная граница |
|---|---|---|---|
| Фото | POST /api/ai-tasks | 3 кредита / результат | Одно исходное лицо и одно целевое изображение |
| Пакет фото | POST /api/ai-tasks/batch-face-swap | 3 кредита / результат | До 20 изображений; всего 95 МБ |
| Группа | POST /api/ai-tasks/multi-face-swap | 3 кредита / выбранное лицо | До 10 сопоставленных лиц; всего 95 МБ |
| Видео | POST /api/ai-tasks/video | 2 кредита за округленную секунду; минимум 6 | MP4, MOV или WebM; 300 секунд; 720p или 1080p |
| GIF | POST /api/ai-tasks/gif | 3 кредита за округленную секунду; минимум 6 | GIF, MP4 или WebM; 30 секунд |
Минимальная интеграция
Сначала проверить запрос, затем создавать задачу
- 1. Храните API-ключ на сервере, а не в браузере, мобильном пакете, логах или публичном репозитории.
- 2. Проверяйте multipart-поля, форматы, размеры, количество, длительность и кредиты для выбранного процесса.
- 3. Отправьте POST и сохраните taskId и ожидаемое списание.
- 4. Опрашивайте GET того же маршрута до COMPLETED, FAILED или CANCELLED.
- 5. Передавайте результат только владельцу задачи и удаляйте медиа по опубликованному правилу хранения.
Оплата, приватность и экспорт
Встройте проверяемые границы в интеграцию
API использует тот же баланс разовых кредитов, что и веб-продукт. Неудачные задачи генерации автоматически возвращаются по текущему правилу продукта. До первой завершенной покупки пробный экспорт изображения содержит DeepSwapAI.com и полный адрес электронной почты аккаунта; покупка влияет только на новые изображения. Загруженные и созданные медиа удаляются с серверов в течение 24 часов, а загрузки не используются для обучения AI-моделей.
Вопросы разработчиков
Проверьте перед запуском
Есть ли webhook?
Пока нет. Сохраните taskId после POST и опрашивайте GET того же маршрута до конечного состояния.
Есть ли официальный SDK?
Официальные языковые SDK пока не опубликованы. Стандартные HTTPS, Bearer, multipart и JSON можно вызвать любым серверным HTTP-клиентом.
Сколько кредитов стоит фото?
Фото, один пакетный результат и одно выбранное лицо на групповом фото сейчас стоят по 3 кредита. Видео и GIF рассчитываются по округленным секундам и минимуму.
Можно ли положить API-ключ во frontend?
Нет. Храните ключ на сервере и не записывайте его в браузерный bundle, мобильный бинарник, логи, события аналитики или тикеты.
Проверьте интеграцию на одной задаче
Сначала проверьте поля, состояния, списание и доставку результата на разрешенном минимальном образце, затем переходите к пакетам или длинному видео.