はじめに
HivisionIDPhotosはオープンソースの軽量なAI写真ID作成ツールで、ユーザーの写真シーンをインテリジェントに識別し、様々な仕様を満たす標準的なID写真を生成するためのキーを入力することができます。このツールは背景色やサイズのカスタムをサポートし、将来的にはビューティー機能やインテリジェントな正装変更機能も導入する予定です。ユーザは、Dockerデプロイメントを通じてローカルサービスを簡単に構築することができ、個人および企業の証明写真作成ニーズに適している。
機能一覧
- 軽量キーイング:効率的なAIアルゴリズムを使用して、ポートレートに正確にキーイングし、透明な背景を持つ画像を生成します。
- マルチサイズID写真生成:パスポート写真、ビザ写真と他の仕様のID写真生成をサポートします。
- 6インチタイプセット写真生成:複数のID写真を標準的な6インチの写真にタイプセットし、印刷やバッチ生産を容易にします。
- インテリジェントな背景変更:ID写真の背景色の追加や変更をサポートします。
- APIサービス:FastAPIベースのAPIサービスで、開発者が証明写真機能を統合するのに便利です。
- Dockerのサポート:サービスの迅速な立ち上げと実行、インストールプロセスの簡素化、システムの互換性の向上。
- ライブ・ウェブ・インタラクション:Gradioデモが提供するローカル・ウェブ・ページを通じて、写真付きID生成プロセスをオンラインで操作する。
ヘルプの使用
インストールと環境設定
- クローニング・プロジェクト
ギット クローン https://github.com/Zeyi-Lin/HivisionIDPhotos.git cd HivisionID写真
- 依存環境のインストール:
pip install -r requirements.txt
- モデルファイルのダウンロード:事前に訓練されたモデルファイルを配置する。
hivision_modnet.onnx
ダウンロードしてプロジェクトのルート・ディレクトリに保存する。
ローカルサービスの運営
- Gradioのデモを開始する:
python app.py
プログラムを実行すると、ローカルのウェブページが生成され、ユーザーはそこでID写真の生成と調整を完了することができる。
- APIサービスのデプロイ
python deploy_api.py
FastAPIを通じてAPIサービスを展開することで、ユーザーはAPIを通じてID写真を生成し、背景を変更することができる。
APIサービスの利用
- ID写真作成のリクエストを送信する:
インポート リクエスト url = "http://127.0.0.1:8080" ファイル = {ファイル: オープン('test.jpg', rb)} response = requests.post()f"{url}/generate_idphoto", files=files) と オープン('idphoto.png', 'wb') として f. f.write(response.content)
- ベースカラーを加える:
インポート リクエスト url = "http://127.0.0.1:8080" ファイル = {ファイル: オープン('idphoto.png', rb)} data = {カラー: '(0,0,0)'} response = requests.post()f"{url}/add_background"ファイル=ファイル、データ=データ) と オープン('idphoto_ab.jpg', 'wb') として f. f.write(response.content)
- 6インチのタイプセット写真を作成する:
インポート リクエスト url = "http://127.0.0.1:8080" ファイル = {ファイル: オープン('idphoto_ab.jpg', rb)} response = requests.post()f"{url}/generate_layout_photos", files=files) と オープン('idphoto_layout.jpg', 'wb') として f. f.write(response.content)
Dockerのデプロイメント
- Dockerイメージをビルドする:
docker build -t hivisionidphotos .
- Dockerコンテナを実行する:
docker run -p 8080:8080 hivisionidphotos