ar-filter-generation

AR フィルター生成

each::sense を使って、クリエイティブな AR フィルターや顔エフェクトを生成します。このスキルでは、Instagram、Snapchat、TikTok などのプラットフォーム向けに、AR フィルターのコンセプト、顔追跡エフェクト、ソーシャルメディア用の顔フィルターの画像や動画を作成します。

機能

• 顔フィルター：動物の耳、鼻、ひげ、キャラクターのオーバーレイ
• ビューティーエフェクト：肌のスムージング、輪郭補正、美肌フィルター
• メイクアップ AR：バーチャルな口紅、アイシャドウ、チーク、フルメイク
• アクセサリー：サングラス、帽子、ジュエリーなどの装着型オーバーレイ
• 背景エフェクト：背景の置き換えやぼかしエフェクト
• 顔の変形：面白い顔の変形やコミカルなエフェクト
• ブランドフィルター：ロゴのオーバーレイやプロモーション用 AR 体験
• 3D 顔追跡：顔の動きに追従するオブジェクト

クイックスタート

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create an AR filter concept showing a person with cute dog ears and a dog nose overlay, playful and fun style"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

AR フィルターの種類とユースケース

フィルターの種類	説明	プラットフォームでの用途
顔フィルター	動物のオーバーレイ、キャラクターマスク	Instagram、Snapchat、TikTok
ビューティーフィルター	肌の補正、顔の輪郭補正	すべてのプラットフォーム
メイクアップエフェクト	バーチャルな化粧品の適用	ビューティーブランド、インフルエンサー
アクセサリー	サングラス、帽子、ジュエリー	ファッション、小売
背景	周囲の置き換え	ビデオ通話、コンテンツ制作
変形	面白い顔の変形	エンターテインメント、バイラルコンテンツ
ブランド	ロゴのオーバーレイ、プロモーション	マーケティングキャンペーン
3D オブジェクト	顔追跡型の 3D 要素	ゲーム、エンターテインメント

ユースケースの例

1. 顔フィルターのデザイン（犬の耳と鼻）

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create an AR filter concept showing a young woman with realistic fluffy golden retriever dog ears on top of her head and a cute black dog nose overlay on her nose. Add subtle whisker dots on cheeks. The filter should look natural and integrate well with the face. Show front-facing selfie view."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

2. ビューティーフィルターエフェクト

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a beauty AR filter effect showing before and after comparison. Show a person with the beauty filter applied: smooth skin, subtle face slimming, brightened eyes, soft glow effect, and enhanced jawline definition. Natural-looking enhancement, not overdone. Professional beauty app style."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

3. メイクアップ AR フィルター

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a virtual makeup AR filter concept. Show a woman with AR-applied makeup: bold red lipstick, smoky eye shadow in bronze and gold tones, defined eyebrows, subtle blush, and winged eyeliner. The makeup should look realistic as if professionally applied. Glamorous evening look. Front-facing portrait."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

4. サングラスとアクセサリーのフィルター

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create an AR try-on filter showing a person wearing virtual aviator sunglasses with gold frames and gradient lenses. Add a matching gold chain necklace and small hoop earrings. The accessories should look photorealistic and properly positioned on the face. Fashion e-commerce style visualization."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

5. 背景置き換えフィルター

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create an AR background replacement filter concept. Show a person in selfie view with their original background replaced by a tropical beach paradise - palm trees, turquoise water, golden sand, sunset sky. Clean edge detection around the person, natural lighting blend between subject and background."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

6. 顔の変形／おもしろフィルター

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a funny face distortion AR filter. Show a person with comically enlarged eyes (anime style big), tiny mouth, and slightly enlarged forehead. Add sparkles around the eyes and a rainbow effect. Cute and comedic style like popular Snapchat filters. Exaggerated but still recognizable."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

7. ブランド AR フィルター（ロゴのオーバーレイ）

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a branded AR filter concept for a sports event. Show a person with face paint in team colors (blue and white stripes on cheeks), a virtual foam finger appearing next to their head, confetti particles falling, and a banner frame around the image that says GO TEAM. Celebratory sports fan atmosphere."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

8. ホリデーテーマのフィルター

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a Christmas holiday AR filter. Show a person wearing a virtual Santa hat, with a red Rudolph nose overlay, snowflakes falling around them, and a subtle frost effect on the edges of the frame. Add twinkling lights in the background. Festive and cheerful holiday spirit."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

9. ゲーム風フィルター（Among Us）

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a gaming-inspired AR filter in the style of Among Us. Transform the person into a crewmate character - their face visible through a space helmet visor, wearing the iconic colored spacesuit (red), with a small pet companion floating nearby. Add a spaceship interior background. Fun and recognizable gaming aesthetic."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

10. 3D オブジェクト顔追跡フィルター

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a 3D face tracking AR filter concept. Show a person with a 3D floating crown hovering above their head that follows head movement, 3D butterflies orbiting around them, and magical sparkle particles emanating from their eyes. The 3D elements should have realistic lighting and shadows. Fantasy magical theme."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'

ベストプラクティス

顔フィルターのデザイン

• 自然な統合：フィルターは顔の特徴に違和感なくなじませます
• 適切な追跡ポイント：標準的な顔のランドマーク（目、鼻、口、額）に合わせてデザインします
• 照明の一貫性：フィルターの照明を一般的な自撮りの照明条件に合わせます
• 適切なサイズ：要素を顔のサイズに合わせた比率にします

プラットフォームに関する考慮事項

• Instagram／TikTok：縦型の 9:16 形式で、モバイルを優先したデザイン
• Snapchat：Lens Studio の機能と制限を考慮します
• ビデオ通話：低解像度でも使える控えめなエフェクト

パフォーマンスのヒント

• シンプルさ：要素を減らすほど、リアルタイムのパフォーマンスが向上します
• 透明度：オーバーレイには適切なアルファチャンネルを使用します
• アニメーション：静止画のデザインをアニメーションフィルターにした場合を考慮します

モードの選択

生成する前にユーザーに確認します。

「高速で低コストにしますか、それとも高品質にしますか？」

モード	最適な用途	速度	品質
max	最終的なフィルターのコンセプト、クライアント向けプレゼンテーション、ポートフォリオ作品	遅め	最高
eco	素早い下書き、コンセプトの検討、ブレインストーミングでのバリエーション作成	速め	良好

複数ターンでのクリエイティブな反復

session_id を使ってフィルターのデザインを反復します。

# Initial filter concept
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a cat face AR filter with whiskers and cat ears"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "cat-filter-project"
  }'

# Iterate based on feedback
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Make the ears more realistic and fluffy, add a pink nose, and include subtle face contouring to make cheeks more cat-like"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "cat-filter-project"
  }'

# Request variation
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a variation with black cat features instead of tabby, and add glowing yellow eyes effect"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "cat-filter-project"
  }'

フィルターコレクションの生成

キャンペーン用に関連する複数のフィルターを生成します。

# Filter 1 - Dog
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create an AR filter with golden retriever dog ears and nose, cute and playful"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "eco",
    "session_id": "animal-filter-pack"
  }'

# Filter 2 - Cat
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Now create a matching cat filter with the same style - tabby cat ears and whiskers"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "eco",
    "session_id": "animal-filter-pack"
  }'

# Filter 3 - Bunny
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Complete the pack with a bunny filter - long floppy ears and a pink bunny nose"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "eco",
    "session_id": "animal-filter-pack"
  }'

エラー処理

エラー	原因	解決策
Failed to create prediction: HTTP 422	残高不足	eachlabs.ai でチャージしてください
コンテンツポリシー違反	禁止されているコンテンツ	プラットフォームのガイドラインに準拠するようプロンプトを調整してください
タイムアウト	複雑な生成	クライアントのタイムアウトを最低 10 分に設定してください

AR フィルターのプロンプトのヒント

AR フィルターのコンセプトを作成する際は、プロンプトに次の詳細を含めてください。

1. フィルターの種類：カテゴリを指定します（顔フィルター、ビューティー、メイクアップなど）
2. 要素：必要なすべてのオーバーレイ要素を列挙します（耳、鼻、アクセサリー）
3. スタイル：リアル、漫画風、ミニマル、凝ったデザイン
4. 配置：顔の特徴に対する各要素の位置
5. エフェクト：パーティクル、発光、カラーグレーディング、歪み
6. プラットフォーム：特定の要件がある場合は対象プラットフォーム
7. 雰囲気：楽しい、華やか、怖い、祝祭的など

プロンプトの構成例

"Create a [filter type] AR filter showing [subject description].
Include [overlay elements] with [style/aesthetic].
Add [effects/particles] and [additional features].
[Platform/mood requirements]."

関連スキル

• each-sense - コア API ドキュメント
• product-photo-generation - 製品のビジュアライゼーション
• video-generation - 動画コンテンツの作成
• image-generation - 一般的な画像の作成