Введение
Что делает этот эндпоинт
Он принимает одно фото и возвращает копию, в которой до трёх лиц, начиная с самого крупного, восстановлены и стали чётче. Всё за пределами лиц остаётся как было, разрешение не меняется. Промпта нет.
Важные входные данные
image_url — это фото: загруженный файл JPEG, PNG или WebP либо публичная ссылка. `Выберите для Face Enhancer настоящее лицо, которое хорошо видно и достаточно крупно в исходнике; операция «восстановление деталей лица на фотографии в Face Enhancer» лучше использует такие детали, чем далёкое или закрытое лицо. Выберите для Face Enhancer настоящее лицо, которое хорошо видно и достаточно крупно в исходнике; операция «восстановление деталей лица на фотографии в Face Enhancer» лучше использует такие детали, чем далёкое или закрытое лицо.
Что вы получите
Одно изображение на запрос в том же разрешении, что и отправленное; оно отдаётся из хранилища платформы после завершения задачи. Для большего числа пикселей используйте /models/image-upscaler-v1.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Эндпоинт | Редактирование изображения |
| Вход | Одна ссылка на фото (JPEG, PNG или WebP) |
| Выход | Одно изображение в JPEG, PNG или WebP в исходном разрешении |
| Лица | До трёх, начиная с самого крупного |
| Всё остальное | Остаётся как было |
| Настройки | Без промпта — только формат файла |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Фото для восстановления: загруженный файл JPEG, PNG или WebP либо публичная ссылка на файл. Не менее 1 символов |
output_format | Нет | jpeg (по умолчанию), png или webp. png не добавляет ещё один цикл сжатия с потерями, но файл больше. |
Стоимость
$0.012 / изображение
Оплата по фиксированной цене за изображение. Формат файла на цену не влияет, неудачные запросы не оплачиваются.
Сценарии использования
Фото, которые уменьшали и пережимали
Снимки, которые прошли через мессенджер, ленту соцсети или несколько сохранений, теряют детали в первую очередь на лице. Пропустите их один раз, чтобы вернуть глаза, брови, бороду и текстуру кожи.
Профильные и командные фото
Подправьте портрет, который выглядит слегка мягким, перед тем как поставить его в профиль, на страницу команды или в био спикера. Кадрирование, свет и фон остаются как при съёмке.
Перед крупной версткой
Сначала приведите лица в порядок, а затем используйте Image Upscaler по адресу /models/image-upscaler-v1, если фото ещё нужны больше пикселей для баннера или печати.
Руководство по промптам и практические советы
Проверьте лица
Лучше всего улучшаются настоящие, достаточно крупные и хорошо видимые лица людей. Сильно перекрытые, очень мелкие или очень размытые лица, а также нарисованные и аниме-лица улучшаются слабее.
Отправьте
image_urlimage_url— это фото в виде загруженного файла JPEG, PNG или WebP либо публичной ссылки. Добавьтеoutput_format, если хотите png или webp вместо jpeg.Опросите и сравните
Вызов асинхронный: создайте задачу, опрашивайте её до завершения и скачайте изображение из хранилища платформы. Сравните с оригиналом в полном размере, особенно глаза и кожу.
Введение
Face Enhancer восстанавливает и делает чётче лица на одном фото. Он находит до трёх лиц, начиная с самого крупного, и воссоздаёт детали, которые отняли сжатие, уменьшение или размытие: глаза, брови, бороду и текстуру кожи. Всё за пределами лиц остаётся как было, а картинка возвращается в том же разрешении, что вы отправили. Промпта нет, и кроме формата файла ничего настраивать не нужно.
Запрос
{
"image_url": "https://example.com/portrait.jpg",
"output_format": "jpeg"
}
image_url — единственное обязательное поле. output_format по умолчанию равен jpeg; задайте png или webp, если предпочитаете их.
Что меняется и что остаётся
Меняются лица, остальная часть фото остаётся прежней. В нашем тесте мы взяли JPEG-портрет мужчины в баре 720×404 и намеренно его испортили: уменьшили вдвое, растянули обратно и сильно сжали. Результат вернулся в 720×404 примерно через 9 секунд обработки. Глаза, брови, борода и текстура кожи стали заметно чётче, при этом мужчина оставался узнаваемым тем же человеком. Кожа получилась немного глаже, чем была бы на настоящем фото, а полка с бутылками за ним сохранила исходные блоки сжатия, потому что фон не затрагивается.
Размер тоже не меняется. Face Enhancer восстанавливает лица в том разрешении, которое вы отправили; если нужны ещё и дополнительные пиксели, используйте Image Upscaler (/models/image-upscaler-v1).
Лица улучшаются сильнее всего, когда они настоящие, достаточно крупные и хорошо видны. У Face Enhancer меньше данных для восстановления на рисунках и аниме, а также при мелких, закрытых или сильно размытых лицах; это ограничивает операцию «восстановление деталей лица на фотографии в Face Enhancer».
Ход задачи
Вызов асинхронный. Выберите для Face Enhancer настоящее лицо, которое хорошо видно и достаточно крупно в исходнике; операция «восстановление деталей лица на фотографии в Face Enhancer» лучше использует такие детали, чем далёкое или закрытое лицо. За один запрос возвращается одно изображение; оплата идёт по фиксированной цене за изображение, а неудачный запрос не оплачивается.
Советы
- Начинайте с фото, на котором лица достаточно крупные и хорошо видны. У лица шириной в несколько десятков пикселей почти нет деталей, из которых можно что-то восстановить.
- Восстанавливаются до трёх лиц, начиная с самого крупного. Остальные лица остаются как были.
- Используйте
png, если результат будут редактировать или сжимать ещё раз: он не добавляет очередного цикла сжатия с потерями, но файл больше. Формат не меняет цену. - Сравните результат с оригиналом в полном размере, особенно вокруг глаз и кожи. В нашем тесте кожа вышла немного глаже, чем на настоящем фото, поэтому исходный файл сохраняйте.
- Нужны и больше пикселей, и более чистые лица? Пропустите фото через Image Upscaler (
/models/image-upscaler-v1).
Быстрый старт 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": "spicyapi/face-enhancer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg"
}
}'
# 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.
