PopNow APIpopnow.ai
Получить API-ключ

Celebrity Look-Alike API

от PopNow

Найди похожую на тебя знаменитость по одному портрету

popnow/look-alike-v1/editОт 8 кредитовза изображение · 0,08 $
Попробовать в PlaygroundПолучить API-ключ
  • Замена лица

О модели Celebrity Look-Alike

Celebrity Look-Alike принимает один портрет и возвращает сгенерированный кадр с самой похожей знаменитостью. Одно поле изображения, ни промпта, ни параметров: это функция в один вызов для развлекательных и социальных продуктов, а не инструмент идентификации.

Вызывайте его по имени модели popnow/look-alike-v1/edit через POST /jobs/createTask, от 8 кредитов за изображение (0,08 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
image_urlДаКартинка, с которой всё начинается.

Цены

Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.

ВариантКредиты за изображение≈ USD
Стандарт7,50,075 $

Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 8 кредитов за изображение (0,08 $).

Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.

Быстрый старт API

Вызов API Celebrity Look-Alike в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/look-alike-v1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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/look-alike-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
  }
}'

# 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 Celebrity Look-Alike

Сколько стоит API Celebrity Look-Alike?

Celebrity Look-Alike стоит 8 кредитов (0,08 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.

Какое имя модели у Celebrity Look-Alike в API?

Укажите popnow/look-alike-v1/edit — Замена лица в поле model запроса POST /jobs/createTask.

Что именно возвращается?

Одно сгенерированное изображение. Endpoint не возвращает ни имени знаменитости, ни списка кандидатов, ни процента сходства, поэтому всё, что показывает ваш продукт, приходится строить вокруг самого кадра.

Работает ли это с групповыми фотографиями?

Нет. Отправляйте по одному лицу на запрос. Если в кадре несколько лиц, определить, кого вы имели в виду, невозможно, и результат становится произвольным.

Можно ли настроить результат?

Нет. Нет ни промпта, ни seed, ни размера, ни выбора формата. Фотография, которую вы отправляете, — единственный вход, меняющий исход.

Это распознавание лиц?

Решая, вправе ли вы это использовать, считайте, что да. На вход подаётся лицо реального человека, а значит, в ряде юрисдикций функция попадает под правила о биометрических данных и изображении гражданина — независимо от того, как вы её преподносите в продукте. Используйте её только с согласия человека на фотографии и прочитайте раздел Limits до запуска.

Можно ли применять её к фотографиям знаменитостей и публичных лиц?

Не надо. Отправка фотографии публичного лица или подача вывода как утверждения о реальном человеке — это ровно тот случай, когда нарушаются права на изображение и на его коммерческое использование. Предполагаемый вход — собственный портрет согласившегося пользователя.

Можно попробовать Celebrity Look-Alike без кода?

Да. Playground запускает Celebrity Look-Alike на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.

Ещё о Celebrity Look-Alike