# はじめに

> WayinVideo API の概要と主要な機能のご紹介。

## はじめに

WayinVideo API を使えば、誰でも AI による動画処理を自動化ワークフローに組み込むことができます。数時間に及ぶ長尺動画を含め、あらゆる長さの動画を高速・安定・効率的に処理できる設計で、ポッドキャスト、ゲーム配信、ウェビナー、チュートリアル、オンラインコース、インタビュー、会議、Vlog、街歩き映像、スポーツ動画、EC 動画、商品デモなど、さまざまなコンテンツパイプラインに対応しています。動画 URL またはアップロードファイルを送信するだけで、AI 生成のクリップ、要約、構造化ノート、文字起こし、高画質化した動画などを取得できます。

## API リスト

- **[AI クリッピング](https://wayin.ai/ja/api-docs/ai-clipping/)**：任意の長さの動画を送信すると、バイラルポテンシャルでランク付けされたクリップを取得できます。自動検出された開始・終了タイムスタンプ、AI 生成のタイトル・説明・ハッシュタグ付き。レンダリング済みクリップのエクスポートも可能です。
- **[モーメント検索](https://wayin.ai/ja/api-docs/find-moments/)**：「面白い瞬間」「興奮するゴールシーン」など、欲しいモーメントを自然言語で説明すると、API があらゆる長さの動画から対応するクリップをタイムスタンプ・タイトル・説明付きで高速に抽出します。エクスポートも可能です。
- **[ソーシャルメディア公開](https://wayin.ai/ja/api-docs/social-media-publishing/)**：ソーシャルメディアアカウントを接続し、AI クリッピングまたはモーメント検索で生成したクリップを YouTube、TikTok、Instagram、Facebook、X / Twitter、LinkedIn などへ公開できます。
- **[動画要約](https://wayin.ai/ja/api-docs/video-summarization/)**：短尺から数時間の長尺コンテンツまで、あらゆる動画から構造化されたオーバービュー、ハッシュタグ、タイムラインハイライトを高速・安定して生成します。
- **[動画ノート](https://wayin.ai/ja/api-docs/video-notes/)**：動画からカスタマイズ可能な AI ノートを生成し、構造化された概要、ハッシュタグ、タイムラインハイライトとともに、Markdown 形式とプレーンテキスト形式で結果を取得します。
- **[動画文字起こし](https://wayin.ai/ja/api-docs/video-transcription/)**：動画または音声コンテンツから、話者分離（speaker diarization）付きの単語レベル文字起こしを抽出します。
- **[動画高画質化](https://wayin.ai/ja/api-docs/video-enhancer/)**：プラットフォーム上の動画ファイルまたはアップロード済みファイルを 1080p、2K、4K に高画質化します。画面内テキストの強調ができ、動画全体または最長 10 分の区間を処理できます。
- **[AI for Stream Videos](https://wayin.ai/solutions/stream)**：WayinVideo の世界最先端 AI は、リアルタイムで世界を理解し、あなたとともに能動的に探索します。Live Stream Understanding and Clipping を支え、AI Hardware and Robotics の頭脳として機能します。利用を申請するには、[お問い合わせフォーム](https://wayin.ai/solutions/stream/#solution-contact-form)をご利用ください。

## 対応動画ソース

API は以下のプラットフォームの URL を受け付けます：

- YouTube
- Vimeo
- Dailymotion
- Kick
- Rumble
- Zoom
- Twitch
- TikTok
- Facebook

対応プラットフォームは順次追加予定です。

[アップロードしたローカルの動画や音声ファイル](https://wayin.ai/ja/api-docs/upload/)も処理できます。

## ベース URL

すべての API リクエストは以下のアドレスに送信します：

```text
https://wayinvideo-api.wayin.ai/api/v2
```

## リクエスト形式

API は RESTful 形式で、JSON フォーマットのリクエストボディを受け付けます。すべてのリクエストに以下のヘッダーを含める必要があります：

```http
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
x-wayinvideo-api-version: v2
```

## レスポンス形式

### 成功（HTTP 200）

リクエストが成功した場合、API は HTTP ステータス **200** を返し、JSON ボディの `data` フィールドにペイロードが格納されます：

```json
{
  "data": {
    "project_id": "prj06928fdjqqaza",
    "name": "Sample project name",
    "status": "SUCCEEDED"
  }
}
```

`data` の構造はエンドポイントごとに異なります。エラーレスポンスやその他の HTTP ステータスコードについては [ステータスコード](https://wayin.ai/ja/api-docs/status-codes/) をご覧ください。

## ステータスのライフサイクル

多くのエンドポイントは非同期処理のステータスを返します。ライフサイクルは以下の通りです：

```text
CREATED → QUEUED → ONGOING → SUCCEEDED / FAILED
```

`SUCCEEDED` または `FAILED` になるまでポーリングでステータスを確認してください。タスクが失敗した場合、レスポンスの `data` に `error_message` フィールドが含まれます。