n8n
n8n の OpenAI クレデンシャルには、カスタムのベース URL を設定できます。一度設定すれば、AI Agent や Basic LLM Chain などのノードで KovAPI のモデルを使えます。
1. OpenAI クレデンシャルを作成する
- Credentials → Add credential → OpenAI。
- API Key に KovAPI のキーを、Base URL に
https://kovapi.com/v1を入力します。Organization ID は空のままにします。 - 保存します。n8n は接続テストのためにモデル一覧を 1 回読み込みますが、これは課金されません。
Base URL
https://kovapi.com/v12. OpenAI Chat Model ノードでモデルを選ぶ
- Model → From List を選ぶと KovAPI の全モデルが一覧表示されるので、対話モデルを選んでください。または ID を選んで
gemini-3.1-proのように直接入力することもできます。 - Use Responses API は既定でオンになっていて、
/v1/responsesにリクエストを送ります。KovAPI はこのエンドポイントで GPT モデルだけを提供しています。GPT 以外のモデルを使うときはオフにしてください。GPT モデルならどちらでも動きます。 - Built-in Tools（Web Search、File Search、Code Interpreter）はオフのままにしてください。これらは OpenAI がホストする機能です。
- OpenAI アプリノードの Message a Model は常に
/v1/responsesを使うため、GPT モデルでしか動きません。ほかのモデルには OpenAI Chat Model ノードを使ってください。
Claude（任意）
Anthropic クレデンシャルを作成し、Base URL に https://kovapi.com/anthropic を、同じ API キーを入力します。そのあと、Anthropic Chat Model ノードで Claude モデルを選んでください。
テスト
Chat Trigger → AI Agent → OpenAI Chat Model というワークフローを組み、Open chat をクリックしてメッセージを送ってみてください。
よくあるエラー
クレデンシャルのテストが失敗する
404 はベース URL に /v1 がない、または間違っていることを示します（https://kovapi.com/v1 が正解です）。401 はキーが正しくないことを示します。
あるモデルが 400、404、503 を返す
多くは GPT 以外のモデルで Use Responses API がオンになっています。オフにしてください。
エージェントがツールを呼び出さない、または JSON 出力が効かない
すべてのモデルがツール呼び出しや JSON 出力に対応しているわけではありません。対応しているモデルを選んでください（各モデルの API ドキュメントをご確認ください）。
