Openclaw向けTukeli Visual API

自動化された背景削除、顔の鮮明化、AIによる背景生成・置換のための包括的なAI画像処理ツールセットです。

cutout-pro

v1.0.0

Mar 16, 2026

インストール

概要情報

Skill.md

インストール＆ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。


                  npx clawhub@latest install tukeli-visual-api

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル

~/.openclaw/skills/

ワークスペース

<project>/skills/

優先順位：ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。


                  Clawhubを使って tukeli-visual-api をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。

ダウンロードをご希望ですか？

ZIPアーカイブで生のスキルファイルを取得します。

Tukeli Visual API とは？

Tukeli Visual API skillは、AI agent環境に高度なコンピュータビジョン機能を提供します。Tukeli REST APIを活用することで、このskillはシームレスな画像切り抜き（人物や物体の背景削除）、低品質な写真を修復する顔面補正、テキストプロンプトに基づいた洗練されたAI背景生成を可能にします。Openclaw Skillsエコシステムの一部として、ニューラルネットワークやGPU管理に関する深い専門知識がなくても、開発者が複雑なビジュアルワークフローを構築できるようにします。

このskillは、ローカルファイルのアップロードと画像URLの両方をサポートし、バイナリストリームまたはBase64エンコードされた文字列として結果を返します。髪の毛レベルの人物セグメンテーションやプロ級の画像修復といった高精度タスク向けに設計されており、自動化されたメディア制作に不可欠なツールです。

Tukeli Visual API のユースケース

Eコマース出品用の商品写真から背景を削除。
ぼやけた画像や低解像度の顔写真を高精細画像に補正。
テキスト説明を使用して、透明なPNG用のプロフェッショナルなAI背景を生成。
メディアおよびマーケティングチーム向けのバッチ画像処理ワークフローの自動化。
プロ向けの人物編集用に、高精度な髪の毛レベルのマスクを抽出。

Tukeli Visual API の仕組み

ユーザーがローカルファイルパスまたはパブリックURL経由で画像を提供し、目的のAPIアクションを指定します。
このskillは、環境変数で設定されたAPI keyを使用してTukeliクラウドサーバーで認証を行います。
切り抜きや顔面補正の場合、APIはリクエストを同期的に処理し、処理済みの画像データを返します。
AI背景置換の場合、このskillは非同期タスクを送信し、タスクIDを取得します。
その後、AIで生成された背景がダウンロード可能になるまで、このskillがタスクステータスをポーリングします。
処理されたファイルは、Openclaw Skillsワークフローへ統合するために、メタデータとともにローカルディレクトリに保存されます。

Tukeli Visual API のセットアップ

このskillを始めるには、以下のインストール手順に従ってください：

Tukeli公式サイトでアカウント登録し、API keyを取得します。
プロジェクトの環境設定にkeyを追加します：

TUKELI_API_KEY=your_secret_api_key

必要なPython依存関係をインストールします：

pip install -r scripts/requirements.txt

CLIを使用して処理スクリプトを実行します：

python scripts/tukeli.py --api matting --image your_photo.jpg --output result.png

Tukeli Visual API のデータスキーマとタクソノミー

このskillは、処理されたアセットと追跡情報を次のように整理します：

データ型	仕様
対応入力	PNG, JPG, JPEG, BMP, GIF, WEBP
出力ディレクトリ	`data/outputs/`
ファイル命名	`{api_type}_{timestamp}.png`
メタデータ保存	処理された各画像に対する `.meta.json` ファイル

メタデータには、使用されたAPI endpoint、処理時間、元のファイルサイズ、変換中に適用された特定のパラメータなどの重要な分類情報が含まれます。

Tukeli Visual API の高度な機能

マルチモード切り抜き：人物、物体、または特定の頭部領域の抽出に最適化されたアルゴリズム。
非同期AI生成：タスクポーリングを伴う、複雑なテキストから画像への背景生成をサポート。
画像調整：透明な空白の自動クロップとカスタムhex-code背景塗りつぶし。
高解像度サポート：最大4096 x 4096ピクセル、25MBまでの画像を処理可能。
シームレスなオーケストレーション：他のOpenclaw Skillsと連携して動作するように設計されており、エンドツーエンドの自動画像編集パイプラインを実現します。