# Codex

> Codex に WayinVideo Skill をインストールし、coding workspace から動画 URL をクリップ、要約、タイムスタンプ、公開向けソーシャルコンテンツに変換します。

## Codex 連携

Codex は **WayinVideo Skill** を workspace assistant として使い、動画理解、AI クリッピング、ショート動画コンテンツ準備を支援できます。

coding environment から別の動画ツールへ切り替える代わりに、scripts、content pipeline、social publishing tool、自動化ロジックの作業中に Codex へ WayinVideo workflow の実行を依頼できます。Skill が動画操作を提供し、WayinVideo API が裏側で処理を行います。

特に、次のような開発者主導のワークフローに適しています：

- content automation script の構築、
- YouTube-to-clips pipeline のテスト、
- social media publishing flow 向けのクリップ準備、
- editorial tool 用のタイムスタンプ抽出、
- 動画 URL を app や CMS 向け structured data に変換。

---

## セットアップ概要

セットアップは 3 つのパートに分かれます：

1. ClawHub から WayinVideo Skill package をダウンロードします。
2. ダウンロードした ZIP ファイルを Codex にインストールさせます。
3. Codex から求められたら WayinVideo API key を入力します。

動画タスクを実行する前に、WayinVideo アカウントに利用可能な API Units があることを確認してください。[WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard) で API key の作成と API Units の購入ができます。

> API key は secret として扱ってください。repository に commit したり、shared logs に貼り付けたり、client-side code で公開したりしないでください。

---

## Codex にインストールする

### 1. Skill ZIP をダウンロード

WayinVideo Skill ページを開きます：

[https://clawhub.ai/wayinvideo/video-understanding-and-ai-clipping](https://clawhub.ai/wayinvideo/video-understanding-and-ai-clipping)

package をコンピューターにダウンロードします。Codex のインストール時に必要になるため、ZIP ファイルのパスを控えておいてください。

### 2. Codex にインストールを依頼

Codex で、ダウンロードしたファイルパスを含むインストールプロンプトを送信します：

```text
Please install the WayinVideo skill package located at [the path of downloaded zip file].
```

例：

```text
Please install the WayinVideo skill package located at /Users/example/Downloads/wayinvideo-video-understanding-and-ai-clipping.zip.
```

### 3. API Key を接続

Skill setup が credentials を要求したら、以下で取得した WayinVideo API key を入力します：

[https://wayin.ai/wayinvideo/api-dashboard](https://wayin.ai/wayinvideo/api-dashboard)

API Units 残高が空の場合は、最初の動画タスクを実行する前に API Units Package を購入してください。

### 4. 必要に応じて Codex をリロード

新しい Skill のインストール後、一部の Codex environment では reload または restart を求められる場合があります。表示された場合は指示に従い、その後 `/wayinvideo` で新しい request を開始します。

---

## 最初の Codex Request

セットアップ後、明確な動画 URL と出力目標を含む短い request から試してください：

```text
/wayinvideo Generate 6 clip candidates from this YouTube video for TikTok and YouTube Shorts. Include start/end timestamps, a short title, why each clip works, and suggested hashtags: [a youtube video link]
```

`[a youtube video link]` をソース動画 URL に置き換えてください。

Codex は WayinVideo Skill 経由で request を処理し、prompt とアカウント設定に応じて、クリップ案、タイムスタンプ、または生成されたクリップ出力を返します。

---

## Codex Prompt Patterns

ソース動画、対象チャンネル、必要な出力を具体的に書くと効果的です。

### クリップキューを作る

```text
/wayinvideo Use AI Clipping on this video and return the strongest short clips. For each clip, include the start time, end time, title, description, and score: https://www.youtube.com/watch?v=example
```

### 商品ページ向けのモーメントを抽出

```text
/wayinvideo Use Find Moments to locate every part where the speaker discusses product benefits or customer objections. Return timestamps and a one-sentence reason for each match: https://www.youtube.com/watch?v=example
```

### SNS キャプションを準備

```text
/wayinvideo Clip this video into vertical short-form ideas for social posting. Prioritize moments with a strong hook, clear takeaway, or surprising statement: https://www.youtube.com/watch?v=example
```

### CMS 向け要約を作成

```text
/wayinvideo Find the best educational moments in this video and summarize each one with its timestamp, topic, and recommended clip title: https://www.youtube.com/watch?v=example
```

---

## Codex Workflow Ideas

| Workflow | Codex での Skill 活用 |
| -------- | --------------------- |
| Content automation | scripts、queues、CMS records にコピーできる clip metadata を生成します。 |
| Social publishing | clip titles、descriptions、hashtags、アカウント向け content plans を準備します。 |
| Editorial review | クリップの export や publish 前に review すべき timestamps を探します。 |
| Product research | speaker が features、comparisons、objections、use cases を話すモーメントを特定します。 |
| Documentation work | video walkthroughs を summaries、highlights、structured notes に変換します。 |

---

## 便利な API リファレンス

Codex 内では Skill が最も簡単な開始方法ですが、custom workflow を構築または debug したい場合は、以下の API リファレンスが役立ちます：

| 必要なこと | API ドキュメント |
| ---------- | ---------------- |
| 長い動画からクリップを生成する | [AI クリッピング API](https://wayin.ai/ja/api-docs/ai-clipping/) |
| prompt で正確なモーメントを検索する | [モーメント検索 API](https://wayin.ai/ja/api-docs/find-moments/) |
| structured summaries と timeline highlights を作成する | [動画要約 API](https://wayin.ai/ja/api-docs/video-summarization/) |
| timing と speaker labels 付き transcripts を抽出する | [動画文字起こし API](https://wayin.ai/ja/api-docs/video-transcription/) |
| render settings 付きで選択したクリップを export する | [Clips Export API](https://wayin.ai/ja/api-docs/clips-export/) |
| 接続済みソーシャルアカウントへクリップを公開する | [ソーシャルメディア公開 API](https://wayin.ai/ja/api-docs/social-media-publishing/) |
| API Units と課金動作を確認する | [Pricing](https://wayin.ai/ja/api-docs/pricing/) |

完全な Skill リファレンスは [動画理解 & AI クリッピング Skill](https://wayin.ai/ja/api-docs/skills-video-understanding-and-ai-clipping/) を参照してください。

---

## トラブルシューティング

### `/wayinvideo` が利用できない

ZIP のインストールが正常に完了したことを確認してください。Codex から reload または restart を求められた場合は、先に実行してから再試行してください。

### Codex が再度 API Key を求める

[API Dashboard](https://wayin.ai/wayinvideo/api-dashboard) から現在有効な WayinVideo API key を入力してください。key を rotate または削除した場合は、最新の active key を使用してください。

### API Units のため Request が失敗する

[WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard) で API Units 残高を確認してください。残高が空の場合は、次の動画タスクを送信する前に API Units Package を追加してください。