Celebrity Look-Alike (look-alike-v1) превращает один портрет в сгенерированное изображение двойника знаменитости, по 0,05 $ за запрос. Ответ — только изображение: без поля с ID знаменитости, без рейтинга, без оценки сходства. Само изображение может быть макетом из двух панелей с напечатанным заголовком, именем знаменитости и подписью «от руки», а надписи могут получиться искажёнными. Учитывайте это при проектировании карточки для публикации и никогда не выдавайте имя за подтверждённую идентификацию.
Look-Alike подходит для добровольной развлекательной функции: пользователь загружает селфи и получает изображение, которым можно поделиться. В нём нет промпта, выбора целевого человека и регулятора силы; для направленной смены одежды или повторяющегося вымышленного персонажа используйте редактор изображений.
Выберите правильный тип API «двойника»
Большинство инструментов для поиска двойников на деле относятся к одному из двух других типов. Сервисы распознавания лиц и проекты с открытым кодом превращают лицо в вектор, ищут по базе знаменитостей и возвращают имена с оценками. Потребительские сервисы показывают проценты вроде «совпадение 92%» без какой-либо методики. Look-Alike не делает ни того, ни другого.
| Вам нужно | Используйте |
|---|---|
| Сгенерированное изображение двойника по одному фото, которым можно поделиться | Look-Alike |
| Ранжированные имена знаменитостей или число сходства | Сервис распознавания или собственный поиск по эмбеддингам в базе, которую вам разрешено хранить по лицензии; Look-Alike не возвращает ни того, ни другого |
| Лицо одного человека на выбранном вами целевом изображении | Endpoint для замены лица |
Что принимает endpoint
| Параметр | Текущий контракт |
|---|---|
| ID модели | spicyapi/look-alike-v1/edit |
| Вход | Один image_url: JPG, PNG, WEBP или GIF, до 10 МБ |
| Цена | 0,05 $ за запрос, списывается, даже если совпадение вам не понравилось |
| Недоступно | Промпт, целевая знаменитость, seed, размер, сила, сходство |
| Хранение | Исходные изображения удаляются через 1 день, результаты — через 14 |
Пример результата Look-Alike со страницы модели: возвращаемое изображение — коллаж из двух панелей с заголовком и напечатанным именем реального человека, поэтому макет, рассчитанный на чистый одиночный портрет, сломается.
Пример на странице модели — коллаж из двух панелей с напечатанным именем и подписью, так что ожидайте надписей на изображении и закладывайте их в макет. Просмотрите реальный экспорт в размере вашей карточки, сохраняйте его пропорции (растяжение до квадрата искажает лица), а если вы обрежете надписи, оставшееся лицо всё равно не является подтверждённым совпадением.
Подготовьте исходное фото
Страница модели перечисляет случаи сбоев: групповые снимки, профиль, солнцезащитные очки, руки или волосы перед лицом, смаз от движения и очень маленькие лица ухудшают совпадение или приводят к ошибке вызова. Берите одно хорошо освещённое, примерно анфас лицо, занимающее разумную часть кадра, с видимыми обоими глазами и линией волос. Примените поворот и обрезку до загрузки: миниатюра в галерее может игнорировать метаданные поворота, которые по-прежнему есть в загружаемых байтах. Увеличение крошечного лица из группового фото не добавляет деталей; попросите новое фото.
Иллюстрация, а не результат Look-Alike: примерно фронтальный портрет взрослой показывает читаемый входной кадр.
Сначала попробуйте в Playground
- Откройте страницу Look-Alike и оставайтесь на вкладке Playground в режиме Form. Для запуска войдите в аккаунт с пополненным балансом.
- Перетащите портрет взрослого человека, давшего согласие, в Input image (JPG, PNG, WEBP или GIF, до 10 МБ) или вставьте прямую ссылку в Asset URL. Больше ничего настраивать не нужно.
- Запустите, затем откройте возвращённое изображение целиком и проверьте его, как описано ниже.
Сначала проверьте здесь самое трудное исходное фото, прежде чем писать код: если совпадение неверное в Playground, оно будет неверным и через API, а решение — более удачное фото.
Затем вызовите из кода
Установите Python SDK (pip install spicyapi), задайте SPICY_API_KEY в окружении вашего сервера и выполните:
import urllib.request
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
photo = client.upload_file("./authorized-adult-portrait.jpg") # becomes a spicy:// URI
task = client.create_task(
model="spicyapi/look-alike-v1/edit",
input_data={"image_url": photo["uri"]},
idempotency_key=str(uuid.uuid4()), # new key per new request; reuse only to retry the same one
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
url = output_assets(final)[0]["url"]
# some script clients get 403 without a User-Agent
request = urllib.request.Request(url, headers={"User-Agent": "look-alike-example/1.0"})
with urllib.request.urlopen(request) as response, open("look-alike.webp", "wb") as out:
out.write(response.read())Отправляйте только image_url: дополнительные свойства, например имя знаменитости, отклоняются. Загрузка файлов, ожидание и повторные попытки описаны в руководстве по задачам и справочнике Python SDK. О вебхуках читайте в сравнении опроса статуса и вебхуков. Результаты удаляются через 14 дней, поэтому копируйте изображение в собственное хранилище, если пользователь хочет его сохранить.
Или поручите запуск Agent
Когда запросы должен выполнять ассистент, CLI и сервер MCP показывают цену и спрашивают подтверждение перед платным вызовом; Skill лишь добавляет инструкции.
- CLI.
spicyapiзапускает одну задачу из терминала (npx @spicyapi/cliработает без установки). Поместите{"image_url": "spicy://..."}вinput.json, используя URI, который выводит загрузка:
``bash spicyapi files upload ./authorized-adult-portrait.jpg spicyapi tasks create --model spicyapi/look-alike-v1/edit --input-file input.json --wait ``
- Сервер MCP. Добавьте сервер MCP своему ассистенту и попросите: «Run Look-Alike on ./authorized-adult-portrait.jpg.» Он вызовет
spicyapi_upload_file, затемspicyapi_task_create, который остановится для подтверждения цены, а потомspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillустанавливает Agent Skill: он заставляет ассистента для программирования читать актуальную схему модели вместо угадывания полей. Сам он задачи не запускает, поэтому используйте его вместе с CLI или MCP.
Проверьте результат до карточки для публикации
Откройте возвращённое изображение целиком, а не фрагмент с лицом. Ищите лишние панели, заголовки, настоящие имена, подписи, дополнительные лица и изменившийся кажущийся возраст. Подпишите результат Generated look-alike portrait (сгенерированный портрет-двойник). Если вы не хотите показывать имя, обрежьте или закройте надписи; оставшееся лицо всё равно не является подтверждённым совпадением. Не пишите рядом «совпадение 93%» или «подтверждённая личность знаменитости» и не показывайте имя, извлечённое из изображения другой моделью, так, будто его оценил Look-Alike. Встроенные надписи — сгенерированное содержимое и могут быть ошибочными.
Иллюстрация, а не результат Look-Alike: просмотрите изображение целиком и всё вокруг лица, прежде чем выбирать экспорт.
Если участнику изображение не нравится, предложите удалить его или попробовать другое фото. Ничто не направляет результат к выбранной знаменитости, поэтому повтор — это новый кандидат за 0,05 $, а не доработка.
| Проблема | Что делать дальше |
|---|---|
| Запрос отклонён | Уберите поля промпта, seed, размера и имени; отправляйте только image_url. |
| Источник не загружается | Замените страницу входа, просроченный URL или ответ HTML на доступное изображение или ссылку spicy://. |
| Лицо нечёткое или найдено не то лицо | Используйте кадр с одним лицом из достаточно качественного оригинала или попросите более чёткий портрет. |
| В изображении есть имя или подпись, которые вы не хотите показывать | Приостановите публикацию и измените подачу; имя — не поле ответа, которое можно запросить или убрать. |
| Участник хочет конкретного персонажа или наряд | Вместо этого используйте редактор изображений с эталонными изображениями. |
| Не удаётся скачать завершённую задачу | Повторите скачивание; не создавайте новый запрос. |
Согласие и публикация
Вход — всегда лицо реального человека, поэтому при оценке юридических обязанностей относитесь к функции как к распознаванию лиц. Биометрические данные регулируются отдельно в ЕС и в ряде штатов США; например, закон BIPA штата Иллинойс требует письменного уведомления и осознанного согласия до сбора биометрических идентификаторов. Используйте фото взрослых, сознательно согласившихся на эту цель, и никогда — фото публичных персон или изображения, взятые из других источников; не используйте Look-Alike для идентификации, верификации, наблюдения или создания базы лиц. Считайте разрешение на генерацию отдельным от разрешения публиковать исходник или результат.
Look-Alike работает без проверки безопасности, поэтому ваш продукт должен сам соблюдать правила по возрасту и содержимому. Не используйте портреты реальных людей для создания сексуальных, интимных или порочащих материалов и не выдавайте результат за утверждение о реальном человеке. Портрет по грудь полностью одетого взрослого — самый безопасный вход по умолчанию для публичной развлекательной функции.
Постройте узкий сценарий: закрытый предпросмотр исходника, состояние обработки, полный результат и явное действие «сохранить» или «поделиться». Не публикуйте автоматически по завершении генерации.
