Введение
Модель принимает один портрет и возвращает сгенерированное изображение самой похожей знаменитости. Ни промпта, ни параметров нет: фотография — это весь вход.
Запрос — один URL изображения, оплата за запрос. Это функция в один вызов для развлекательных и социальных продуктов, а не инструмент идентификации.
Ключевые возможности и особенности
Одно фото на входе, один кадр на выходе — больше отправлять нечего
Весь запрос — один URL изображения. Нет ни промпта, ни seed, ни размера, ни силы, так что на результат влияет только загруженная фотография. Отправьте её и опрашивайте задачу, чтобы получить кадр, как и при любом другом медиавызове в этом каталоге; цена за запрос одна и та же, кто бы ни оказался в кадре.
Сгенерированный кадр, а не имя и не оценка
В ответе одно изображение и больше ничего: ни имени знаменитости, ни рейтинга кандидатов, ни процента сходства. Всё, что стоит рядом с кадром, — ваш текст, а не утверждение модели, и так безопаснее. Стройте момент вокруг самого кадра: показывайте его, дайте им поделиться и не ставьте рядом число.
Решая, можно ли это использовать, относитесь к этому как к распознаванию лиц
На вход всегда подаётся лицо реального человека, поэтому этот эндпоинт подпадает под правила об изображении личности и биометрических данных, которые не касаются ничего другого в каталоге. Биометрические данные отдельно регулируются в Европейском союзе и в части США, и требования к согласию там бывают высокими. Отправляйте только фото, на которые изображённый человек сознательно согласился, — никогда фото публичных лиц и никогда изображения, взятые из других мест, — и никогда не используйте эндпоинт для идентификации, верификации, слежки или создания базы лиц. Ничто из возвращаемого не является утверждением о реальном человеке; загруженные исходные изображения удаляются через один день, а сгенерированные результаты — через 14.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Один чёткий, примерно фронтальный портрет с единственным различимым лицом. Не менее 1 символов |
Стоимость
$0.05 / запрос
Совпадение, которое вы бы не выбрали, всё равно считается выполненным запросом и оплачивается.
Сценарии использования
Одна загрузка — один кадр, которым можно поделиться
Используйте этот эндпоинт, когда сценарий в продукте — загрузка одного фото и сгенерированный кадр, которым можно поделиться. Отправьте портрет как image_url, опросите задачу и покажите вернувшееся изображение; имени или оценки, которые можно было бы вывести рядом, нет.
Развлекательные и социальные функции
Взаимодействие «На какую знаменитость вы похожи?» — один вызов API за загрузкой фото. Это момент, которым делятся в пользовательском приложении, а не производственный инструмент.
Механики кампаний
Лёгкий интерактивный шаг в маркетинговой воронке: загрузите селфи — получите кадр, которым можно поделиться. Один вызов на участника делает стоимость предсказуемой.
Фото- и бьюти-приложения
Развлекательная функция рядом с уже существующими инструментами для портретов. Ей не нужны ни работа с промптами, ни параметры, поэтому она встраивается в приложение одним полем формы.
Руководство по промптам и практические советы
Ждите изображение, а не вердикт
Эндпоинт возвращает сгенерированный кадр, а не имя, рейтинг или оценку сходства. Если вашему продукту нужна подпись, показывать придётся сам кадр — ничего другого API для вывода не даёт.
Отправляйте чёткий портрет анфас
Одно хорошо освещённое лицо, примерно обращённое к камере и занимающее заметную часть кадра. Групповые снимки, выраженный профиль, солнечные очки, смаз от движения и очень мелкие лица — случаи, когда сходство ухудшается или вызов не удаётся вовсе.
Проверьте результат, прежде чем повторять
Одно лицо на изображение, примерно анфас и хорошо освещённое. Ракурсы в профиль, перекрытия (солнечные очки, руки, волосы на лице), смаз от движения и очень мелкие лица ухудшают сходство или приводят к ошибке вызова. Нет ни промпта, ни маски, ни силы, ни seed: если результат не тот, помочь может только другое фото. Ответ — это изображение и больше ничего: ни имени, ни рейтинга, ни показателя уверенности.
Быстрый старт 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/look-alike-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# 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.