verify-endpoints

name: verify-endpoints description: 全AIプロバイダーのAPIエンドポイント（チャット・TTS・STT・Embedding）を動作確認し、レポートを出力する。 allowed-tools: Read, Bash, Grep, Glob, Task, Write user-invocable: true

AIプロバイダーエンドポイント動作確認スキル

全てのAIプロバイダーのエンドポイントに対してテストリクエストを送信し、動作状況をレポートします。

前提条件

開発サーバーが http://localhost:3000 で起動していること
.env または .env.local ファイルにAPIキーが設定されていること

実行手順

1. 開発サーバーの確認

まずサーバーが起動しているか確認します：

curl -s -o /dev/null -w "%{http_code}" http://localhost:3000/ --max-time 5

200 が返れば起動中
それ以外の場合は、ユーザーに npm run dev でサーバーを起動するよう案内して中断

2. 環境変数の確認

.env ファイルを読み込み、設定済みのAPIキーを特定します。以下の環境変数をチェック：

プロバイダー	環境変数
OpenAI	`OPENAI_API_KEY`
Anthropic	`ANTHROPIC_API_KEY`
Google	`GOOGLE_API_KEY`
Azure	`AZURE_API_KEY` + `AZURE_ENDPOINT`
xAI	`XAI_API_KEY`
Groq	`GROQ_API_KEY`
Cohere	`COHERE_API_KEY`
Mistral AI	`MISTRALAI_API_KEY`
Perplexity	`PERPLEXITY_API_KEY`
Fireworks	`FIREWORKS_API_KEY`
DeepSeek	`DEEPSEEK_API_KEY`
OpenRouter	`OPENROUTER_API_KEY`
Dify	`DIFY_API_KEY` + `DIFY_URL`
OpenAI TTS	`OPENAI_TTS_KEY` または `OPENAI_API_KEY`
Azure TTS	`AZURE_TTS_KEY` + `AZURE_TTS_ENDPOINT`
ElevenLabs	`ELEVENLABS_API_KEY`
Cartesia	`CARTESIA_API_KEY`
Google TTS	`GOOGLE_TTS_KEY`
Koeiromap	`NEXT_PUBLIC_KOEIROMAP_KEY`
Aivis Cloud	`AIVIS_CLOUD_API_KEY`

値が空文字列("")のものは「未設定」として扱う。

3. AIチャットエンドポイントのテスト（非ストリーミング）

/api/ai/vercel/ エンドポイントに対して、設定済みの各プロバイダーでテストリクエストを送信します。

注意: Next.jsの trailingSlash: true 設定により、全APIルートでトレイリングスラッシュ (/) が必須。スラッシュなしの場合 308 リダイレクトが返る。本スキル内の全curlコマンドはこれに対応済み。

リクエスト形式

curl -s -w "\n%{http_code}" -X POST http://localhost:3000/api/ai/vercel/ \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Hello, respond with just OK"}],
    "aiService": "<SERVICE_NAME>",
    "model": "<DEFAULT_MODEL>",
    "stream": false,
    "temperature": 0.5,
    "maxTokens": 50
  }' \
  --max-time 30

各プロバイダーのデフォルトモデル

サービス名	aiService	デフォルトモデル
OpenAI	`openai`	`gpt-4.1-mini`
Anthropic	`anthropic`	`claude-sonnet-4-5`
Google	`google`	`gemini-2.5-flash`
Azure	`azure`	※ endpointのdeployment名を使用
xAI	`xai`	`grok-4`
Groq	`groq`	`llama-3.3-70b-versatile`
Cohere	`cohere`	`command-a-03-2025`
Mistral AI	`mistralai`	`mistral-large-latest`
Perplexity	`perplexity`	`sonar-pro`
Fireworks	`fireworks`	`accounts/fireworks/models/llama-v3p3-70b-instruct`
DeepSeek	`deepseek`	`deepseek-chat`
OpenRouter	`openrouter`	`openai/gpt-4.1-mini`

判定基準：

HTTPステータス 200 かつレスポンスにテキストが含まれていれば成功
HTTPステータス 400 で EmptyAPIKey → APIキー未設定（スキップ扱い）
その他のエラー → 失敗（エラーメッセージを記録）

4. AIチャットエンドポイントのテスト（ストリーミング）

主要プロバイダーについて、ストリーミングモード (stream: true) でも正常にレスポンスが返るか確認します。ストリーミング固有の問題（イベント形式の不備、reasoning-delta欠落など）を検知する目的。

リクエスト形式

curl -s -N -X POST http://localhost:3000/api/ai/vercel/ \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Say OK"}],
    "aiService": "<SERVICE_NAME>",
    "model": "<DEFAULT_MODEL>",
    "stream": true,
    "temperature": 0.5,
    "maxTokens": 50
  }' \
  --max-time 30

対象プロバイダー: openai, anthropic, google（主要3社のみ）

判定基準：

レスポンスに "type":"text-delta" が1つ以上含まれていれば成功
空レスポンスまたはエラーJSON → 失敗

5. Reasoningストリーミングテスト

推論（reasoning/thinking）モードが正常に動作し、reasoning-delta イベントがストリーミングされることを確認します。

5.1 OpenAI Reasoning（`o4-mini`）

条件：OPENAI_API_KEY が設定済み

curl -s -N -X POST http://localhost:3000/api/ai/vercel/ \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "What is 15 multiplied by 17? Think carefully."}],
    "aiService": "openai",
    "model": "o4-mini",
    "stream": true,
    "reasoningMode": true,
    "reasoningEffort": "medium",
    "temperature": 1.0,
    "maxTokens": 512
  }' \
  --max-time 30

判定基準：

ストリームに "type":"reasoning-delta" が1つ以上含まれていれば成功
reasoning-start → reasoning-end のみで reasoning-delta がない → 失敗（providerOptions に reasoningSummary が設定されていない可能性）
エラーレスポンス → 失敗

5.2 Anthropic Thinking（`claude-3-7-sonnet-latest`）

条件：ANTHROPIC_API_KEY が設定済み

curl -s -N -X POST http://localhost:3000/api/ai/vercel/ \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "What is 15 multiplied by 17?"}],
    "aiService": "anthropic",
    "model": "claude-3-7-sonnet-latest",
    "stream": true,
    "reasoningMode": true,
    "reasoningTokenBudget": 4096,
    "temperature": 1.0,
    "maxTokens": 512
  }' \
  --max-time 30

判定基準：

ストリームに "type":"reasoning-delta" が1つ以上含まれていれば成功
reasoning-delta がない → 失敗
エラーレスポンス → 失敗

5.3 Google Thinking（`gemini-2.5-flash`）

条件：GOOGLE_API_KEY が設定済み

curl -s -N -X POST http://localhost:3000/api/ai/vercel/ \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "What is 15 multiplied by 17?"}],
    "aiService": "google",
    "model": "gemini-2.5-flash",
    "stream": true,
    "reasoningMode": true,
    "reasoningTokenBudget": 4096,
    "temperature": 1.0,
    "maxTokens": 512
  }' \
  --max-time 30

判定基準：

ストリームに "type":"reasoning-delta" が1つ以上含まれていれば成功
reasoning-delta がない → 失敗
エラーレスポンス → 失敗

6. Difyエンドポイントのテスト

DIFY_API_KEY と DIFY_URL の両方が設定されている場合のみ実行：

curl -s -w "\n%{http_code}" -X POST http://localhost:3000/api/difyChat/ \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Hello, respond with just OK",
    "stream": false,
    "conversationId": ""
  }' \
  --max-time 30

7. カスタムAPIエンドポイントのテスト

/api/ai/custom エンドポイントは外部APIのURLが必要なため、自動テストはスキップする。レポートには「外部URL未指定のためスキップ」と記載する。

8. TTSエンドポイントのテスト

各TTSエンドポイントにテストリクエストを送信します。短いテキスト「テスト」を使用。

8.1 OpenAI TTS (`/api/openAITTS`)

条件：OPENAI_TTS_KEY または OPENAI_API_KEY が設定済み

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/openAITTS/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "テスト",
    "voice": "shimmer",
    "model": "tts-1",
    "speed": 1.0
  }' \
  --max-time 30

成功: ステータス 200

8.2 Azure OpenAI TTS (`/api/azureOpenAITTS`)

条件：AZURE_TTS_KEY と AZURE_TTS_ENDPOINT が設定済み

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/azureOpenAITTS/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "テスト",
    "voice": "alloy",
    "speed": 1.0
  }' \
  --max-time 30

8.3 ElevenLabs (`/api/elevenLabs`)

条件：ELEVENLABS_API_KEY が設定済み

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/elevenLabs/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "test"
  }' \
  --max-time 30

8.4 Google TTS (`/api/tts-google`)

条件：GOOGLE_TTS_KEY が設定済み

curl -s -w "\n%{http_code}" -X POST http://localhost:3000/api/tts-google/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "テスト",
    "ttsType": "ja-JP-Wavenet-A",
    "languageCode": "ja-JP"
  }' \
  --max-time 30

8.5 Cartesia (`/api/cartesia`)

条件：CARTESIA_API_KEY が設定済み

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/cartesia/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "test",
    "language": "en"
  }' \
  --max-time 30

8.6 Koeiromap (`/api/tts-koeiromap`)

条件：NEXT_PUBLIC_KOEIROMAP_KEY が設定済み

curl -s -w "\n%{http_code}" -X POST http://localhost:3000/api/tts-koeiromap/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "テスト",
    "speakerX": 0,
    "speakerY": 0,
    "style": "talk",
    "apiKey": ""
  }' \
  --max-time 30

※ apiKey は .env から取得した NEXT_PUBLIC_KOEIROMAP_KEY の値を使う

8.7 Aivis Cloud API (`/api/tts-aivis-cloud-api`)

条件：AIVIS_CLOUD_API_KEY と NEXT_PUBLIC_AIVIS_CLOUD_MODEL_UUID が設定済み

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/tts-aivis-cloud-api/ \
  -H "Content-Type: application/json" \
  -d '{
    "text": "テスト",
    "modelUuid": "<MODEL_UUID>",
    "speed": 1.0
  }' \
  --max-time 30

8.8 VOICEVOX (`/api/tts-voicevox`) - ローカルサービス

条件：VOICEVOXエンジンが起動しているか確認（デフォルト localhost:50021）

# まずローカルサーバーの稼働確認
curl -s -o /dev/null -w "%{http_code}" http://localhost:50021/version --max-time 5

起動中の場合のみテスト：

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/tts-voicevox/ \
  -H "Content-Type: application/json" \
  -d '{
    "text": "テスト",
    "speaker": 46,
    "speed": 1.0,
    "pitch": 0,
    "intonation": 1.0
  }' \
  --max-time 30

※ speaker は .env の NEXT_PUBLIC_VOICEVOX_SPEAKER の値を使用。pitch と intonation は必須パラメータ（未指定だと500エラー）。

8.9 AivisSpeech (`/api/tts-aivisspeech`) - ローカルサービス

条件：AivisSpeechエンジンが起動しているか確認（デフォルト localhost:10101）

# まずローカルサーバーの稼働確認
curl -s -o /dev/null -w "%{http_code}" http://localhost:10101/version --max-time 5

起動中の場合のみテスト：

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/tts-aivisspeech/ \
  -H "Content-Type: application/json" \
  -d '{
    "text": "テスト",
    "speaker": 633572448,
    "speed": 1.0,
    "pitch": 0,
    "intonationScale": 1.0
  }' \
  --max-time 30

※ speaker は .env の NEXT_PUBLIC_AIVIS_SPEECH_SPEAKER の値を使用。pitch と intonationScale は必須パラメータ（未指定だと500エラー）。VOICEVOXでは intonation、AivisSpeechでは intonationScale とパラメータ名が異なる点に注意。

8.10 Style-Bert-VITS2 (`/api/stylebertvits2`)

条件：STYLEBERTVITS2_SERVER_URL が設定済み（ローカルの場合はサーバー稼働確認も行う）

curl -s -o /dev/null -w "%{http_code}" -X POST http://localhost:3000/api/stylebertvits2/ \
  -H "Content-Type: application/json" \
  -d '{
    "message": "テスト",
    "stylebertvits2ModelId": "0",
    "stylebertvits2Style": "Neutral",
    "stylebertvits2SdpRatio": "0.2",
    "stylebertvits2Length": "1.0",
    "selectLanguage": "ja"
  }' \
  --max-time 30

注意: GSVI TTSはクライアントサイドから直接外部サーバーを呼び出す方式のため、Next.js APIルートが存在しない。テスト対象外。

9. Embeddingエンドポイントのテスト (`/api/embedding`)

条件：OPENAI_API_KEY が設定済み

curl -s -w "\n%{http_code}" -X POST http://localhost:3000/api/embedding/ \
  -H "Content-Type: application/json" \
  -d '{
    "text": "テスト"
  }' \
  --max-time 30

10. ローカルLLMサービスの確認

10.1 Ollama

curl -s -o /dev/null -w "%{http_code}" http://localhost:11434/api/tags --max-time 5

10.2 LM Studio

curl -s -o /dev/null -w "%{http_code}" http://localhost:1234/v1/models --max-time 5

稼働している場合は利用可能なモデル一覧も取得して表示する。

11. レポート出力

全テスト完了後、reports/endpoints/ ディレクトリにMarkdownレポートを出力します。

ファイル名: reports/endpoints/verify-YYYY-MM-DD-HHmmss.md

レポート形式

# AIプロバイダー エンドポイント動作確認レポート

実行日時: YYYY-MM-DD HH:mm:ss

## サマリー

| カテゴリ           | 成功  | 失敗  | スキップ | 合計  |
| ------------------ | ----- | ----- | -------- | ----- |
| AIチャット(batch)  | X     | X     | X        | X     |
| AIチャット(stream) | X     | X     | X        | X     |
| Reasoning          | X     | X     | X        | X     |
| TTS                | X     | X     | X        | X     |
| その他             | X     | X     | X        | X     |
| **合計**           | **X** | **X** | **X**    | **X** |

## AIチャットエンドポイント（非ストリーミング）

| プロバイダー | モデル            | ステータス  | 詳細          |
| ------------ | ----------------- | ----------- | ------------- |
| OpenAI       | gpt-4.1-mini      | ✅ 成功     | 200 OK        |
| Anthropic    | claude-sonnet-4-5 | ✅ 成功     | 200 OK        |
| Google       | gemini-2.5-flash  | ❌ 失敗     | 403 Forbidden |
| Azure        | -                 | ⏭️ スキップ | APIキー未設定 |
| ...          | ...               | ...         | ...           |

## AIチャットエンドポイント（ストリーミング）

| プロバイダー | モデル            | ステータス | 詳細                    |
| ------------ | ----------------- | ---------- | ----------------------- |
| OpenAI       | gpt-4.1-mini      | ✅ 成功    | text-delta イベント確認 |
| Anthropic    | claude-sonnet-4-5 | ✅ 成功    | text-delta イベント確認 |
| Google       | gemini-2.5-flash  | ❌ 失敗    | ストリームが空          |
| ...          | ...               | ...        | ...                     |

## Reasoningストリーミング

| プロバイダー | モデル                   | ステータス | reasoning-delta数 | 詳細                    |
| ------------ | ------------------------ | ---------- | ----------------- | ----------------------- |
| OpenAI       | o4-mini                  | ✅ 成功    | 45                | reasoning-delta確認済み |
| Anthropic    | claude-3-7-sonnet-latest | ✅ 成功    | 12                | reasoning-delta確認済み |
| Google       | gemini-2.5-flash         | ❌ 失敗    | 0                 | reasoning-delta未検出   |
| ...          | ...                      | ...        | ...               | ...                     |

## TTSエンドポイント

| プロバイダー | エンドポイント    | ステータス  | 詳細                   |
| ------------ | ----------------- | ----------- | ---------------------- |
| OpenAI TTS   | /api/openAITTS    | ✅ 成功     | 200 OK                 |
| VOICEVOX     | /api/tts-voicevox | ✅ 成功     | ローカルサーバー稼働中 |
| ElevenLabs   | /api/elevenLabs   | ⏭️ スキップ | APIキー未設定          |
| ...          | ...               | ...         | ...                    |

## ローカルサービス

| サービス    | URL             | ステータス | 詳細          |
| ----------- | --------------- | ---------- | ------------- |
| VOICEVOX    | localhost:50021 | ✅ 稼働中  | version X.X.X |
| AivisSpeech | localhost:10101 | ❌ 停止中  | 接続不可      |
| Ollama      | localhost:11434 | ✅ 稼働中  | N個のモデル   |
| LM Studio   | localhost:1234  | ❌ 停止中  | 接続不可      |

## その他

| エンドポイント | ステータス  | 詳細                        |
| -------------- | ----------- | --------------------------- |
| Embedding      | ✅ 成功     | 200 OK                      |
| Custom API     | ⏭️ スキップ | 外部URL未指定のためスキップ |

## エラー詳細

(失敗したテストの詳細なエラーメッセージをここに記載)

実行上の注意

APIコストに注意: 各プロバイダーへのリクエストで少額のAPI利用料が発生する可能性がある（Reasoningテストは推論トークンを消費するため通常より高コスト）
タイムアウト: 各リクエストは30秒のタイムアウトを設定
テストデータ: 最小限のリクエスト（「テスト」「OK」等の短文）を使用してコストを最小化
並列実行禁止: APIのレートリミットを避けるため、テストは順次実行する
ローカルサービス: まずポートの疎通確認を行い、応答がない場合は即座にスキップ
トレイリングスラッシュ: Next.jsの trailingSlash: true 設定により、全APIルートでトレイリングスラッシュ必須（なしだと308リダイレクト）
GSVI TTS: クライアントサイド直接呼び出し方式のため、APIルートが存在しない。テスト対象外
Custom API: 外部URLの指定が必要なため、自動テストはスキップ。レポートにはスキップとして記載

テスト対象外のAPIルート

以下のエンドポイントはAIプロバイダーの動作確認の範囲外のため、このスキルではテストしない：

/api/ai/custom - カスタムAPI（外部URL必須のためスキップ）
/api/whisper - 音声認識（音声ファイル入力が必要）
/api/messages - メッセージ処理
/api/get-vrm-list, /api/get-live2d-list, /api/get-pngtuber-list - モデル一覧取得
/api/get-background-list, /api/get-image-list - アセット一覧取得
/api/upload-image, /api/delete-image, /api/upload-vrm-list, /api/upload-background - アセット管理
/api/update-voicevox-speakers, /api/update-aivis-speakers - スピーカー情報更新
/api/getSlideFolders, /api/updateSlideData, /api/convertSlide - スライド機能
/api/getSupplement, /api/convertMarkdown - コンテンツ変換
/api/memory-files, /api/memory-restore - メモリ管理
/api/save-chat-log - チャットログ保存
/api/youtube/continuation - YouTube連携

引数

$ARGUMENTS を使って動作を制御できます：

chat - AIチャットエンドポイントのみテスト（batch + stream）
tts - TTSエンドポイントのみテスト
reasoning - Reasoningストリーミングテストのみ
local - ローカルサービスの確認のみ
<provider名> - 特定のプロバイダーのみテスト（例: openai, voicevox）
引数なし - 全エンドポイントをテスト

name: verify-endpoints description: 全AIプロバイダーのAPIエンドポイント（チャット・TTS・STT・Embedding）を動作確認し、レポートを出力する。 allowed-tools: Read, Bash, Grep, Glob, Task, Write user-invocable: true

AIプロバイダー エンドポイント動作確認スキル

前提条件

実行手順

1. 開発サーバーの確認

2. 環境変数の確認

3. AIチャットエンドポイントのテスト（非ストリーミング）

リクエスト形式

各プロバイダーのデフォルトモデル

4. AIチャットエンドポイントのテスト（ストリーミング）

リクエスト形式

5. Reasoningストリーミングテスト

5.1 OpenAI Reasoning（o4-mini）

5.2 Anthropic Thinking（claude-3-7-sonnet-latest）

5.3 Google Thinking（gemini-2.5-flash）

6. Difyエンドポイントのテスト

7. カスタムAPIエンドポイントのテスト

8. TTSエンドポイントのテスト

8.1 OpenAI TTS (/api/openAITTS)

8.2 Azure OpenAI TTS (/api/azureOpenAITTS)

8.3 ElevenLabs (/api/elevenLabs)

8.4 Google TTS (/api/tts-google)

8.5 Cartesia (/api/cartesia)

8.6 Koeiromap (/api/tts-koeiromap)

8.7 Aivis Cloud API (/api/tts-aivis-cloud-api)

8.8 VOICEVOX (/api/tts-voicevox) - ローカルサービス

8.9 AivisSpeech (/api/tts-aivisspeech) - ローカルサービス

8.10 Style-Bert-VITS2 (/api/stylebertvits2)

9. Embeddingエンドポイントのテスト (/api/embedding)

10. ローカルLLMサービスの確認

10.1 Ollama

10.2 LM Studio

11. レポート出力

レポート形式

実行上の注意

テスト対象外のAPIルート

引数

AIプロバイダーエンドポイント動作確認スキル

5.1 OpenAI Reasoning（`o4-mini`）

5.2 Anthropic Thinking（`claude-3-7-sonnet-latest`）

5.3 Google Thinking（`gemini-2.5-flash`）

8.1 OpenAI TTS (`/api/openAITTS`)

8.2 Azure OpenAI TTS (`/api/azureOpenAITTS`)

8.3 ElevenLabs (`/api/elevenLabs`)

8.4 Google TTS (`/api/tts-google`)

8.5 Cartesia (`/api/cartesia`)

8.6 Koeiromap (`/api/tts-koeiromap`)

8.7 Aivis Cloud API (`/api/tts-aivis-cloud-api`)

8.8 VOICEVOX (`/api/tts-voicevox`) - ローカルサービス

8.9 AivisSpeech (`/api/tts-aivisspeech`) - ローカルサービス

8.10 Style-Bert-VITS2 (`/api/stylebertvits2`)

9. Embeddingエンドポイントのテスト (`/api/embedding`)