ドキュメント
クイックスタート
Kunavo は OpenAI ワイヤー互換です。すでに OpenAI SDK をお使いの場合、変更するのはベース URL だけです。ゼロから始めて 5 分で、最先端モデルを初めて呼び出せます。
Kunavo は独立した OpenAI 互換の AI API ゲートウェイです。1つの API キーと従量課金残高で、Claude、GPT、画像、動画、音声の各モデルを利用でき、プロバイダーごとのアカウントは必要ありません。 導入は全 4 ステップです。最初の 3 ステップは初回のみ必要です。4 つ目の API 呼び出しは、base_url を差し替えるだけです。
1. アカウントを作成する
kunavo.com/app/login で Google またはメールのマジックリンクを使って登録します。従量課金制で、チャージは $10 からです。残高に有効期限はなく、失敗したリクエストに料金が発生することもありません。
2. API キーを作成する
ダッシュボードで /app/keys を開き、新しいキー をクリックします。キーは sk-kn- で始まり、作成時に 一度だけ 表示されます。コピーして安全に保管してください。
推奨される管理方法：
- プロジェクト／環境（dev、staging、prod）ごとにキーを 1 つ使用する。
- インシデント発生時、または四半期ごとにキーをローテーションする。
- CI からスクリプトで呼び出す場合は、キーごとに月間利用上限を設定する。
3. ウォレットに入金する
/app/billingに移動し、Stripe Checkoutでチャージします。Stripeが対応するすべての地域でカードを利用でき、インド以外ではApple Pay、Google Pay、Linkも利用できます。さらに国ごとの現地決済方法（米国のACH、ブラジルのPix、インドのUPI、韓国のKakaoPay、オランダのiDEAL、ポーランドのBLIKなど）が表示されます。完全な一覧は請求リファレンスにあります。PayPalとSEPA Direct Debitは提供されていません。チャージは$10からで、実際のキーですべてのモデルを試すのに十分です。残高は失効しません。
- 従量課金制：利用料金はウォレット残高からリアルタイムで差し引かれ、サブスクリプションはありません。
- ボリュームボーナスが適用されます：$100 → +$10、$1,000 → +$200、$5,000 → +$1,250。
- カード明細に表示される請求名：
KUNAVO.COM* TOPUP。
4. 最初の API 呼び出しを行う
カタログ から有効なモデルを選びます。以下では、接続を確認するため、低コストで高速な claude-haiku-4-5 のチャット呼び出しを行います。
Python（OpenAI SDK）
openai Python パッケージ（v1 以降）はそのまま動作します。base_url の接続先を Kunavo に設定するだけです。
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1",
)
resp = client.chat.completions.create(
model="claude-haiku-4-5",
messages=[{"role": "user", "content": "Say hi in one sentence."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-haiku-4-5",
messages: [{ role: "user", content: "Say hi in one sentence." }],
});
console.log(resp.choices[0].message.content);curl
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-haiku-4-5",
"messages": [{"role": "user", "content": "Say hi in one sentence."}]
}'/app/usage に表示されます。その他のモダリティ
同じ SDK で画像と動画も扱えます。可能な限り、エンドポイントには OpenAI と同じ名称を使用しています。
画像生成
Nano Banana、Nano Banana 2、Nano Banana Pro、GPT-Image-2 など、任意の画像モデルを使用できます。詳しくは 画像のドキュメント をご覧ください。
img = client.images.generate(
model="nano-banana",
prompt="a tiny red origami crane on a white desk",
size="1024x1024",
)
print(img.data[0].url)ストリーミングチャット
stream=True を設定します。ストリーミングは、Claude と GPT の全ファミリーを含むすべてのチャットモデルで利用できます。応答は OpenAI 標準形式のサーバー送信イベント（SSE）です。
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Tell me a 2-line haiku about CI/CD."}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)