OpenAI互換APIガイド — Ollamaのローカルエンドポイントからホスト型最先端モデルまで

「OpenAI互換」とは、OpenAIの/v1/chat/completionsと同じ通信形式をAPIが使用することです。そのため、base_urlだけを変更すれば、任意のOpenAI SDKまたはツールを利用できます。Ollamaはマシン上でローカル実行されるモデル向けにOpenAI互換エンドポイントを提供します。Kunavoは、Claude、GPT、画像・動画・音声モデルなどのホスト型最先端モデル向けに、1つのBearerトークンで利用できるエンドポイントを提供します。このガイドでは、そのパターンと、コードを書き換えずに両者を切り替える方法を説明します。

「OpenAI互換」の意味

OpenAI Chat Completions形式は事実上の標準になりました。messages配列を入力し、choices[].messageを出力し、ストリーミングにはServer-Sent Events、関数呼び出しにはtoolsを使用します。この契約に準拠するエンドポイントは「OpenAI互換」です。公式のopenai SDK（Python、Node、および各種コミュニティポート）は、base_urlを設定することでそのエンドポイントを利用できます。

Ollamaパターン（ローカル）

Ollamaはオープンモデルをローカルで実行し、http://localhost:11434/v1で提供します。

from openai import OpenAI

# Ollama exposes an OpenAI-compatible endpoint on localhost
client = OpenAI(base_url="http://localhost:11434/v1", api_key="ollama")

resp = client.chat.completions.create(
    model="llama3.1",
    messages=[{"role": "user", "content": "Summarize this changelog."}],
)
print(resp.choices[0].message.content)

同じコード、ホスト型の最先端モデル（Kunavo）

まったく同じSDKをKunavoに向けて、最先端モデルを選択します。変更するのはbase_url、api_key、modelだけで、呼び出しはバイト単位で同一です。

import os
from openai import OpenAI

# Same SDK, same call shape — only base_url, api_key and model change
client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key=os.environ["KUNAVO_API_KEY"],
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",  # or claude-haiku-4-5, gpt-5-5, gpt-5-6-terra...
    messages=[{"role": "user", "content": "Summarize this changelog."}],
)
print(resp.choices[0].message.content)

/app/keysでキーを取得してください。クイックスタートにはNodeとcurlの形式があります。

ローカルとホスト型 — どちらを使うべきか

一般的な構成は、オフライン開発にはlocalhostでOllamaを使い、本番環境のホスト型品質にはKunavoを使う方法です。環境変数を1つ変更するだけで切り替えられます。両端が実装するフィールド単位の契約 — パラメータ、ストリーミングデルタ、tool_calls、usageオブジェクト、Ollamaのv1サーフェスとのパリティ表 — については、/v1/chat/completionsリファレンスと、そのOllama OpenAI互換性セクションをご覧ください。

実行時にモデルを検出する

Ollamaの/api/tagsと同様に、KunavoはOpenAI形式のカタログを公開しています。ハードコードせず、実行時にスラッグを解決してください。

# Discover every enabled model (OpenAI-shaped, like Ollama's /api/tags)
curl https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer $KUNAVO_API_KEY"

チャット以外

同じキーで画像（/v1/images/generations）、動画（/v1/video/generations）、音声エンドポイントにアクセスできます。すべてOpenAI形式です。Kunavoが他のゲートウェイとどう異なるかは、マルチモーダルAIガイドとOpenRouterとの比較をご覧ください。

通常の「互換性」の定義を超える、知っておく価値のあるサーフェスが1つあります。それがPOST /v1/responsesです。Codex CLIはResponses API経由でのみカスタムプロバイダーを受け付けるため、多くのOpenAI互換ゲートウェイではまったく動かせません。Codexのトークン単価では、実行可能な設定ブロックを使ってこの仕組みを詳しく説明しています。キャッシュ済み入力を含むGPTワークロードの料金を計算するには、OpenAI API料金計算ツールにご自身のトークン数を入力してください。

よくある質問