mcpField
V
video-color-grading

video-color-grading

github.com/eachlabsクリエイティブ・メディア44633 回インストール今日更新
リポジトリ

video-color-grading について

video-color-gradingは、each::senseを使って動画にルックを加え、色を補正するスキルです。映像の雰囲気作りや色の問題の修正、複数クリップの色調統一を行う制作者向けです。

主な機能

  1. 01シネマ調とフィルムルック
  2. 02ムードに応じた色調
  3. 03ホワイトバランスと露出補正
  4. 04ビンテージとモノクロ処理
  5. 05HDR強化とクリップの色合わせ

活用シーン

  1. 01物語映像にシネマ調のカラーグレーディング
  2. 02KodakやFujiのフィルムルックを再現
  3. 03色かぶりと露出の補正
  4. 04編集する複数クリップの色調統一

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/eachlabs/skills --skill video-color-grading

インストール後、Claude Code で/video-color-gradingを入力して読み込まれたか確認します。

同梱ファイルreferences/SSE-EVENTS.md

詳細

動画のカラーグレーディング

each::sense を使用して、動画にプロフェッショナルなカラーグレーディングとカラーコレクションを適用します。このスキルでは、映画のようなルック、フィルムストックのエミュレーション、ムードに合わせたカラー処理、技術的なカラー補正が可能です。

特徴

  • シネマティックなグレーディング:ストーリー性のあるコンテンツ向けのハリウッド風カラー処理
  • フィルムエミュレーション:Kodak、Fuji などのクラシックなフィルムストックのルック
  • ルック開発:オレンジ&ティール、ムーディーな暗めのスタイル、明るく軽やかなスタイル
  • カラーコレクション:ホワイトバランス、露出、色かぶりの問題を修正
  • ビンテージ/レトロ:80 年代、90 年代、VHS、ノスタルジックなカラー処理
  • 白黒:トーンを調整したシネマティックなモノクロ変換
  • HDR 強化:ダイナミックレンジの拡張とトーンマッピング
  • カラーのマッチング:異なるクリップ間でカラーグレーディングを合わせる

クイックスタート

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": "Apply a cinematic color grade to this video with teal shadows and warm highlights"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/my-video.mp4"]
  }'

カラーグレーディングのスタイル

スタイル説明最適な用途
シネマティック黒を締め、色のコントラストを強調し、フィルムのような質感にしますストーリー、ドラマ
オレンジ&ティール肌の色を暖かく、背景を寒色系にしますアクション、大作映画
フィルムエミュレーションKodak/Fuji のフィルムストックの特徴を再現しますインディー作品、ミュージックビデオ
ムーディーな暗めのスタイルローキーで彩度を抑え、雰囲気を演出しますスリラー、ホラー
明るく軽やかなスタイルシャドウを持ち上げ、柔らかなパステル調にします結婚式、ライフスタイル
ビンテージ/レトロ色あせた、暖かみのあるノスタルジックな雰囲気にしますミュージックビデオ、コマーシャル
白黒シネマティックなモノクロにしますアート映画、ドラマチックな作品
HDR 強化ダイナミックレンジを拡張し、鮮やかにします自然、旅行

使用例

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": "Apply a cinematic color grade to this video. I want crushed blacks, slightly desaturated midtones, and a subtle teal push in the shadows with warm highlights. Make it look like a modern Hollywood film."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/raw-footage.mp4"]
  }'
2. フィルムエミュレーション(Kodak Vision3)
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": "Color grade this video to look like it was shot on Kodak Vision3 500T film stock. I want that classic film look with natural skin tones, rich shadows, and subtle grain. Tungsten balanced with warm color science."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/digital-footage.mp4"]
  }'
3. オレンジ&ティールのルック
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": "Apply the classic orange and teal color grade to this video. Push warm orange tones into the skin and highlights, and cool teal into the shadows and backgrounds. Make it punchy like a Michael Bay film but not over the top."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/action-scene.mp4"]
  }'
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": "Give this video a vintage 1980s look. Faded blacks, warm color cast, reduced saturation with boosted reds and yellows. Add subtle softness and that nostalgic analog feel. Think retro music video aesthetic."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/modern-footage.mp4"]
  }'
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": "Convert this video to cinematic black and white. I want high contrast with deep blacks and bright highlights. Focus on dramatic tonal separation. Think classic film noir or modern prestige drama. Rich monochrome, not flat."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/color-footage.mp4"]
  }'
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": "This video was shot with incorrect white balance - it has a strong orange/yellow color cast from tungsten lighting. Please correct the white balance to neutral, fix the skin tones to look natural, and balance the overall exposure. Keep it looking natural, just properly corrected."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/bad-white-balance.mp4"]
  }'
7. クリップ間でカラーを合わせる
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": "I have two video clips that need to match. The first video is my reference with the color grade I like. Please apply the same color grade to the second video so they look consistent when edited together. Match the contrast, saturation, color temperature, and overall tone."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": [
      "https://example.com/reference-clip.mp4",
      "https://example.com/clip-to-match.mp4"
    ]
  }'
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": "Apply a moody, dark color grade to this video. I want crushed shadows, desaturated colors with selective color pops, and a cold blue-green tint. Think David Fincher or Denis Villeneuve - atmospheric and brooding. Low-key lighting feel even if the original is brighter."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/scene-footage.mp4"]
  }'
9. 明るく軽やかなグレーディング
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": "Give this video a bright and airy look perfect for wedding or lifestyle content. Lift the shadows, add soft pastel tones, slightly warm skin tones, and reduce contrast for that dreamy quality. Clean, fresh, and romantic feeling. Keep it natural but elevated."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/wedding-footage.mp4"]
  }'
10. HDR 強化
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": "Enhance this video with HDR-style color grading. Expand the dynamic range, bring out detail in both shadows and highlights, boost color vibrancy without oversaturation. Make skies more dramatic, colors more vivid, and overall image more impactful. Great for landscape and travel footage."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/landscape-video.mp4"]
  }'

ベストプラクティス

カラーグレーディングのヒント
  • 参考画像:一貫した結果を得るために、具体的な映画やビジュアルの参考例を説明します
  • 具体的に指定する:シャドウの色、ハイライトの暖かさ、コントラストの強さ、彩度について伝えます
  • 肌の色:自然な肌の色を保つことが重要な場合は、必ず伝えます
  • まずムードを伝える:実現したい感情やムードから始め、その後に技術的な詳細を指定します
技術的な考慮事項
  • ソースの品質:元の映像の品質が高いほど、より良いグレーディング結果が得られます
  • 一貫性:session_id を使うと、複数のクリップを同じルックでグレーディングできます
  • まずプレビュー:手早くプレビューするには eco モードを、最終出力には max を使用します
よく使われる用語
用語説明
リフトシャドウの明るさを調整します
ガンマ中間調の明るさを調整します
ゲインハイライトの明るさを調整します
クラッシュ黒を純黒よりも深くします
プッシュ特定のトーン範囲に色味を加えます
色かぶり画像全体に生じる不要な色味

モードの選択

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

「速く安価な処理と、高品質な処理のどちらがよいですか?」

モード最適な用途速度品質
max最終成果物、クライアント向けの制作物遅め最高
ecoクイックプレビュー、ルックの検討、下書き速め良好

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

session_id を使ってカラーグレーディングを調整します。

# Initial grade
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": "Apply a cinematic teal and orange grade to this video"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "color-grade-project-001",
    "video_urls": ["https://example.com/my-video.mp4"]
  }'

# Refine the grade
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": "The teal is too strong in the shadows. Can you reduce it and add more warmth to the skin tones?"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "color-grade-project-001"
  }'

# Apply to additional clips
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": "Apply the same grade we developed to this new clip"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "color-grade-project-001",
    "video_urls": ["https://example.com/second-clip.mp4"]
  }'

複数動画の一括カラーグレーディング

複数のクリップを同じルックでグレーディングします。

# Grade first clip and establish look
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": "Apply a moody cinematic grade to this video - this will be my hero look for the project"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "music-video-grade",
    "video_urls": ["https://example.com/clip-01.mp4"]
  }'

# Apply same look to remaining clips
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": "Apply the same color grade to these additional clips for consistency"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "music-video-grade",
    "video_urls": [
      "https://example.com/clip-02.mp4",
      "https://example.com/clip-03.mp4",
      "https://example.com/clip-04.mp4"
    ]
  }'

エラー処理

エラー原因解決方法
Failed to create prediction: HTTP 422残高不足eachlabs.ai でチャージしてください
コンテンツポリシー違反禁止されているコンテンツ動画がコンテンツポリシーに準拠していることを確認してください
タイムアウト動画処理が複雑クライアントのタイムアウトを最低 10 分に設定してください
動画が長すぎる処理上限を超えています動画を短いセグメントに分割してください

カラーグレーディングのプロンプトのヒント

カラーグレーディングを依頼する際は、次の詳細を含めてください。

  1. 参考:映画、監督、またはビジュアルスタイルの参考例
  2. ムード:感情的なトーン(ムーディー、明るい、ドラマチック、柔らかい)
  3. シャドウの処理:色と深さ(黒つぶれ、持ち上げる、色を付ける)
  4. ハイライトの処理:暖かさ、ロールオフ、色
  5. 彩度:全体的な彩度と個別の色の強さ
  6. コントラスト:高め、低め、または特定のカーブ形状
  7. 肌の色:自然、暖色系、またはスタイライズ
プロンプトの構成例
"Apply a [style] color grade to this video.
I want [shadow description] shadows and [highlight description] highlights.
The mood should be [mood/emotion].
Reference: [film or visual reference].
[Specific requirements like skin tones, saturation, etc.]"

関連スキル

  • each-sense - コア API ドキュメント
  • video-generation - ゼロから動画を生成
  • video-editing - 動画コンテンツを編集・変更
  • image-color-grading - 静止画像をカラーグレーディング

コメント