Findclone API by vypivshiy [modified]

Описание

findclone-api - это неофициальное API для взаимодействия с Findclone . Присутствет синхронная и асинхронная версии модулей и типизация объектов чтобы модная и современная IDE всё подсказывала, да для более удобной работы.

Установка через pip

pip install https://github.com/alexgoryushkin/findclone_api/archive/main.zip

Изменения форка

Изменено возвращаемое значение метода upload
[Profiles, BytesIO] -> Tuple[Optional[Image], dict]

Requirements

requests
aiohttp
Pillow

Примеры использования [устарели]:

# sync findclone example
from Findclone import FindcloneApi, is_image

if __name__ == '__main__':
    phone = "+123456172"
    password = "foobar"
    f = FindcloneApi()
    f.login(phone, password)
    print(f)  # get account information
    # upload photo
    profiles = f.upload("test.jpg")
    # or send image url
    # profiles = f.upload("https://example.com/image.png")
    # work with return object:
    if is_image(profiles):  # check return object
        print("write file")
        with open("return_image.jpg", "wb") as file:
            file.write(profiles.getvalue())
    else:
        for profile in profiles:
            print(profile)  # return profile.__str__()
            print(profile.url, profile.score)
    histories = f.history()
    for history in histories:
        print(history)

# async findclone example
import asyncio
from Findclone import FindcloneAsync, is_image, save_image


async def main(login, password):
    # контектстный менеджер, который автоматически закроет сессию
    async with FindcloneAsync() as f:
        await f.login(login, password)
        print(await f.info)
        profiles = await f.upload("file.jpg")
        if is_image(profiles):
            save_image(profiles, "out.jpg")
        else:
            for profile in profiles:
                print(profile)
                print(profile.url, profile.score)
    # Или вместо контекстного менеджера можно вручную открывать и закрывать сессию
    f = FindcloneAsync()
    await f.login(login, password)
    # ... какой то код
    await f.close()


if __name__ == '__main__':
    login = "123123123"
    password = "foobar"
    loop = asyncio.get_event_loop()
    loop.run_until_complete(main(login, password))

Кейс если обнаружены на фото 2 и более лиц

test.jpg:

import Findclone

if __name__ == '__main__':
    phone = "+123456172"
    password = "foobar"
    f = Findclone.FindcloneApi()
    f.login(phone, password)
    profiles = f.upload("test.jpg")
    # write or send object:
    print("write file")
    if Findclone.is_image(profiles):
        Findclone.save_image(profiles, "out.jpg")
    ...

out_image.jpg: Из результата с фотографии, выбираем id лица (указан под квадратом):

...
face_box_id = 0
profiles = f.upload("test.jpg", face_box_id=face_box_id)
for profile in profiles:
    print(profile)

Больше примеров

Краткое описание объектов