Улучшение лицО модели Face Enhancer
Face Enhancer восстанавливает и делает резче до трёх лиц на одном фото, начиная с самого крупного. Остальное изображение не меняется, разрешение сохраняется, а результат вы получаете в JPEG, PNG или WebP. Промпт писать не нужно.
Вызывайте его по имени модели popnow/face-enhancer-v1/edit через POST /jobs/createTask, от 0,012 $.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
image_url | Да | Картинка, с которой всё начинается. |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
Цены
Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
| Вариант | USD за изображение |
|---|---|
| Стандарт | 0,012 $ |
До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.
Быстрый старт API
Вызов API Face Enhancer в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/face-enhancer-v1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/face-enhancer-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Face Enhancer
Сколько стоит API Face Enhancer?
Face Enhancer стоит 0,012 $ за изображение. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
Какое имя модели у Face Enhancer в API?
Укажите popnow/face-enhancer-v1/edit — Улучшение лиц в поле model запроса POST /jobs/createTask.
Увеличивает ли он мою фотографию?
Нет. Результат возвращается в том разрешении, которое вы отправили: наше тестовое фото 720×404 вернулось в 720×404. Если нужны больше пикселей, используйте Image Upscaler по адресу /models/image-upscaler-v1.
Сколько лиц он исправляет?
До трёх, начиная с самого крупного. Остальные лица на фото, как и всё остальное за пределами лиц, остаются без изменений.
Будет ли человек на фото всё ещё похож на себя?
В наших тестах люди оставались узнаваемо теми же. Детали воссоздаются, поэтому перед публикацией сравните результат с оригиналом.
Что он не трогает, а что немного смягчает?
Фон не затрагивается: в нашем тесте полка с бутылками за героем сохранила исходные блоки сжатия. Кожа на лице получилась немного глаже, чем была бы на настоящем фото.
Можно попробовать Face Enhancer без кода?
Запускайте Face Enhancer в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.
Все модели Face Enhancer
Image Upscaler увеличивает всё изображение; Face Enhancer исправляет лица без изменения их размера.