WaveSpeed LLM API クイックスタート:エンドポイント、APIキー、OpenAI互換セットアップ
WaveSpeed LLMを初めて使うユーザーが必ず聞く3つの質問:エンドポイントは何か、APIキーは何か、どのプロトコルを使うか。このガイドはPython、Node.js、curlのコピペ可能なコードとともに、3つすべてに答えます。
WaveSpeedAIで90以上のLLMを探索 — Claude、GPT、Gemini、Qwen、DeepSeek、Llama、Grok、Mistralなど、OpenAI互換の単一エンドポイントで利用可能。LLMカタログ → · プレイグラウンド →
入力が必要な3つのフィールド
チャットアプリ、SDK、またはIDEに新しいLLMプロバイダーを追加する際、ほぼ必ず同じ3つの情報を求められます:
- エンドポイント / ベースURL — APIの場所。
- APIキー — プロバイダーがあなたを識別する手段。
- チャットプロトコル — OpenAI Chat Completions、Anthropic Messages、またはその他。
WaveSpeed LLMの場合、答えはシンプルです:
| フィールド | 値 |
|---|---|
| ベースURL | https://llm.wavespeed.ai/v1 |
| APIキー | WaveSpeed APIキー(ダッシュボードから取得) |
| プロトコル | OpenAI Chat Completions(OpenAI SDKとドロップイン互換) |
以上です。ツールが「カスタムOpenAI互換エンドポイント」をサポートしていれば、WaveSpeed LLMはそのまま動作します。
WaveSpeed LLMとは?
WaveSpeed LLMは、単一のOpenAI互換エンドポイントを通じて30以上のプロバイダーから90以上の言語モデルにアクセスできる統合APIです — Claude Opus 4.6、GPT-5.2、Gemini 3、DeepSeek、Llama 4、Qwen 3、Grok 4、Mistralなど。APIキー1つ、ベースURL1つ、リクエスト形式1つ。
コールドスタートなし。トークン単位の課金。サブスクリプション不要。無料枠から始められます。
ステップ1:APIキーを取得する
- wavespeed.aiにアクセスしてサインイン(Google/メール)。
- ダッシュボードを開き、APIキーセクションを見つける。
- 新しいキーを作成します — 長いランダムな文字列のように見えます。すぐにコピーして、シークレットとして保存してください。
このキーはパスワードと同様に扱ってください。gitにコミットしたり、スクリーンショットに貼り付けたりしないでください。
ステップ2:ベースURLを設定する
LLM APIはこちらにあります:
https://llm.wavespeed.ai/v1
Chat Completionsエンドポイントはこちらです:
https://llm.wavespeed.ai/v1/chat/completions
ツールが「OpenAI Base URL」、「API Endpoint」、または「Custom Server URL」を求める場所には、https://llm.wavespeed.ai/v1を貼り付けてください。
ステップ3:モデルを選ぶ
モデルIDはvendor/model形式を使用します。人気のあるものをいくつか紹介します:
| モデルID | 備考 |
|---|---|
deepseek/deepseek-v4-flash | オープンウェイト、強力なコーディング |
完全なカタログはwavespeed.ai/llmでご覧いただけます。
ステップ4:最初のAPIコールを実行する
Python(OpenAI SDK)
import os
from openai import OpenAI, OpenAIError
api_key = os.getenv("WAVESPEED_API_KEY")
if not api_key:
raise RuntimeError("Set WAVESPEED_API_KEY before running this example")
client = OpenAI(
base_url="https://llm.wavespeed.ai/v1",
api_key=api_key,
timeout=120.0,
max_retries=2,
)
# The SDK sends this request to https://llm.wavespeed.ai/v1/chat/completions.
try:
response = client.chat.completions.create(
model="deepseek/deepseek-v4-flash",
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content or "")
except OpenAIError as exc:
raise SystemExit(f"LLM request failed: {exc}") from exc
Node.js(OpenAI SDK)
import OpenAI from 'openai';
if (!process.env.WAVESPEED_API_KEY) throw new Error('Set WAVESPEED_API_KEY');
const client = new OpenAI({
apiKey: process.env.WAVESPEED_API_KEY,
baseURL: 'https://llm.wavespeed.ai/v1',
timeout: 120_000,
maxRetries: 2
});
try {
const response = await client.chat.completions.create({
model: 'deepseek/deepseek-v4-flash',
messages: [{ role: 'user', content: 'Hello!' }]
});
console.log(response.choices[0]?.message?.content ?? '');
} catch (error) {
console.error('LLM request failed:', error);
process.exitCode = 1;
}
curl
curl --fail-with-body --connect-timeout 10 --max-time 120 --retry 2 --retry-all-errors \
https://llm.wavespeed.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
-d '{
"model": "deepseek/deepseek-v4-flash",
"messages": [{"role": "user", "content": "Hello!"}]
}'
OpenAIを直接呼び出す場合との違いは、base_urlとmodel文字列だけであることに注目してください。既存のOpenAIコードはそれ以外は変更なしで動作します。
ストリーミング、ツール、ビジョン
OpenAIのChat Completionsエンドポイントで使用するすべての機能がWaveSpeed LLMでも動作します:
stream: true— サーバー送信イベントのストリーミング。toolsとtool_choice— 関数呼び出し(対応モデルのみ)。response_format: { type: "json_object" }— JSONモード。- ビジョン対応モデルでの
content: [{ type: "image_url", image_url: { url: "..." } }]による画像入力。
プロトコルが同一なので、OpenAIをベースに構築されたライブラリやフレームワーク — LangChain、LlamaIndex、Vercel AI SDK、Haystack — はベースURLを変更するだけで動作します。
トラブルシューティング
「無効なAPIキー」/ 401エラー
WaveSpeedダッシュボードのAPIキーを使用しているか確認してください(OpenAIや他のプロバイダーのものではありません)。ヘッダーはAuthorization: Bearer <key>である必要があります。
「モデルが見つかりません」/ モデルの404エラー
モデルIDは大文字小文字を区別し、ベンダープレフィックスを含める必要があります。deepseek/deepseek-v4-flashを使用してください(claude-opus-4.6やClaude-Opus-4.6ではありません)。
「プロトコルが間違っています」 ツールが「OpenAI」、「Anthropic」、「Gemini」などから選択を求める場合は、常にOpenAIを選択してください。WaveSpeed LLMはClaudeやGeminiモデルを含むすべてのモデルにOpenAI Chat Completionsを使用しています。モデルIDのベンダープレフィックスがアップストリームモデルを選択し、リクエスト形式はOpenAI互換のままです。
ネットワーク / 接続の問題
エンドポイントはhttps://llm.wavespeed.ai/v1です — llm.サブドメインに注意してください(api.ではありません)。ファイアウォールがカスタムサブドメインをブロックしている場合は、llm.wavespeed.aiを許可リストに追加してください。
WaveSpeed LLMを選ぶ理由
- OpenAI互換。 すべてのOpenAI SDK、LangChain、Vercel AI SDK、カスタムベースURLに対応したあらゆるツールで動作します。
- コールドスタートなし、サブスクリプション不要。 使った分だけ支払い、透明なトークン単位の料金体系。
- 無料枠あり。 クレジットカードなしで構築を始められます。
今すぐ構築を始めよう
3つのフィールド — ベースURL、APIキー、OpenAIプロトコル — だけで準備完了です。
wavespeed.ai/llmでAPIキーを取得して、5分以内に最初のAPIコールを実行しましょう。





