Запрос cURL
POST /api/v1/image/profilecurl -X POST "https://avatarlookup.com/api/v1/image/profile" \
-H "X-API-Key: sk_your_api_key" \
-F "file=@avatar.jpg"
product image_profile
Анализ профиля по изображению
Загрузите любое изображение и получите атрибуты портрета: оценку возраста, пол, тип изображения, цвет волос и тон кожи.
Стоимость использования: 0,002 $ / проверкаРежим ответа: Синхронный
POST /api/v1/image/profileКонтракт API
Один запрос — мгновенный результат
Загрузите одно изображение как поле multipart-файла с именем file. Аутентификация — по вашему ключу API.
Скопируйте команду curl ниже и замените только пример ключа API на свой.
Ответ
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "image_profile",
"identifier": "img:7013df96c540904a4b7ba295e9162ab2",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}Как использовать
Три главных момента анализа изображений
Отправляйте само изображение
Одно изображение на запрос, как поле multipart-файла с именем file. JPEG, PNG, WebP или GIF, до 2 МБ. Номер или email не нужны — ответ описывает изображение, а не аккаунт.
Сначала читайте category
category сообщает, что изображено. Изображения питомцев, мультяшных персонажей, пейзажей или предметов анализируются и оплачиваются, но не содержат полей возраста и пола.
Мы не храним изображение
Изображение передаётся сразу на анализ и никогда не сохраняется. identifier — это отпечаток, вычисленный по содержимому изображения, поэтому одно и то же изображение всегда даёт одно и то же значение — используйте его для дедупликации на своей стороне.
Что проверяется
Что возвращает Анализ профиля по изображению?
Возвращаемые поля
identifier· string — Отпечаток отправленного изображения, вычисленный по его содержимому. Одно и то же изображение всегда даёт одно и то же значение.category· string — Что изображено: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar или object. unknown, если получить портрет не удалось.age· integer — Оценка возраста целым числом с точностью примерно до 3 лет, в диапазоне 0–80. Отсутствует, если оценить не удалось (например, когда не определён пол).gender· string — male, female или unknown.skin_color· string — Описательный тон кожи, например white, east_asian или hispanic. Считайте набор значений открытым; unknown, если не определено.hair_color· string — Описательный цвет волос, например black, brown, blond или gray white. Считайте набор значений открытым; unknown, если не определено.
Лучше всего подходит для
Используйте этот продукт, когда нужно
Архивы аватаров
Добавляйте единообразные отпечатки, типы изображений и атрибуты портрета к историческим аватарам и изображениям, сокращая ручной просмотр и классификацию.
Профилирование аудитории
Упорядочивайте материалы по типу изображения, оценке возраста, полу, цвету волос и тону кожи, чтобы изучить состав коллекции и затем находить записи.
Первичная сортировка при модерации
Сначала выявляйте портреты, групповые фото, мультяшных персонажей, питомцев, пейзажи и предметы, затем направляйте каждое изображение в нужный процесс ручной проверки.
Обогащение данных
Записывайте результаты анализа в данные клиентов, контента или материалов, чтобы записи, у которых было только изображение, получили структурированные поля для фильтрации.
Краткий ответ
Что такое Анализ изображений?
Анализ профиля по изображению возвращает собственные атрибуты изображения: тип изображения, пол, оценку возраста, тон кожи и цвет волос. Отправьте одно изображение на эндпоинт изображений как поле multipart-файла с именем file и прочитайте атрибуты портрета на верхнем уровне того же ответа API. Идентификатор не требуется.
Чёткие границы
Что не возвращается
- Результат описывает изображение, а не человека или аккаунт: в нём нет утверждений о регистрации, доступности или личности.
- Возраст, пол, тон кожи и цвет волос — алгоритмические оценки по одному изображению. Используйте их только как вспомогательные сигналы — никогда как основу для верификации личности, дискриминационной фильтрации или любых решений с высокими ставками.
- Изображения без человека тоже дают результат и тоже оплачиваются. Бесплатны только ошибка сервиса, изображение, которое не удаётся загрузить или прочитать, и ответ модели без единого поля.
FAQ по продукту
Вопросы о продукте «Анализ изображений»
Что возвращает Анализ профиля по изображению?
Он возвращает собственные атрибуты изображения: тип изображения, пол, оценку возраста, тон кожи и цвет волос в том же синхронном ответе.
Как оплачивается «Анализ изображений»?
Баланс списывается за каждое изображение, по которому получен результат, включая питомцев, мультяшных персонажей и пейзажи. Бесплатны только ошибка сервиса, изображение, которое не удаётся загрузить или прочитать, и ответ модели без единого поля.
Какие форматы и размеры изображений принимаются?
JPEG, PNG, WebP или GIF, до 2 МБ на изображение. Тип определяется по содержимому файла, а не по его расширению.
Вы храните изображение?
Нет. Изображение передаётся сразу на анализ и никогда не записывается на диск или в объектное хранилище. В записи о проверке сохраняется только отпечаток, вычисленный по его содержимому.
Похожие продукты
Другие продукты анализа аватаров
Начните проверку прямо сейчас
Создайте аккаунт, чтобы пользоваться всеми продуктами из панели SaaS или через API: проверки в реальном времени и асинхронные массовые проверки расходуют один и тот же баланс.