4-4 AI クイックスタート:5分で統一AI APIに接続
このチュートリアルでは、4-4 AI への接続をゼロから最後まで案内します:キー取得 → Base URL 設定 → 最初のストリーミング出力を動かすまで。全体を通して OpenAI 互換インターフェースを使います——カスタム Base URL に対応した既存のコード・フレームワーク・ツール(openai SDK、LangChain、Cursor など)はコードロジックを変える必要がなく、設定を変えるだけです。
事前準備
- www.4-4.vip にアクセスし、アカウント登録のうえコンソールにログインします。
- コンソールでチャージするか、カードコードでクレジットを引き換えます。
- 「トークン」ページで新しい API キー(
sk-...形式)を作成し、大切に保管してください——作成時に一度だけ完全な形で表示されます。
中核概念:Base URL とキー
4-4 AI は OpenAI と完全互換のインターフェースプロトコルを提供します。覚えるべき設定は 2 つだけです:
| 設定項目 | 値 |
|---|---|
| Base URL | https://www.4-4.vip/v1 |
| API Key | コンソールのトークンページで作成した sk-... キー |
| model パラメータ | 必要に応じてモデル名を指定します。例:deepseek-chat、glm-4 など(コンソールのモデルリストが基準) |
モデル切替 = model パラメータを変えるだけ。プロバイダ切替 = Base URL を変えるだけ。これが統一ゲートウェイの中核的な価値です:ビジネスコードとモデルプロバイダの分離。
方法1:cURL(接続確認が最速)
curl https://www.4-4.vip/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $44AI_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "Introduce yourself in one sentence"}
]
}'
返された JSON に choices[0].message.content が含まれていれば、リンク全体が疎通しています。
方法2:Python(openai 公式 SDK)
pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["44AI_API_KEY"], # your 4-4 AI key
base_url="https://www.4-4.vip/v1" # key: point to the 4-4 AI gateway
)
# regular call
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)
# streaming output
stream = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta
if delta and delta.content:
print(delta.content, end="", flush=True)
方法3:Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.N44_API_KEY,
baseURL: "https://www.4-4.vip/v1",
});
const completion = await client.chat.completions.create({
model: "deepseek-chat",
messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);
主要フレームワーク・ツールの接続
- LangChain / LlamaIndex:OpenAI 互換コンポーネントを使い、
base_url/openai_api_baseを上記アドレスに設定するだけです。 - Cursor / Claude Code / Cherry Studio などの AI ツール:「カスタム API / OpenAI 互換」設定に Base URL とキーを入力します。
- 自社開発プログラム:OpenAI プロトコルに対応した任意の HTTP クライアントで直接呼び出せ、追加 SDK は不要です。
よくある質問(FAQ)
401 Invalid API Key エラーが出る?
順番に確認してください:① キーをコピーしたとき空白や改行が混入していないか;② コンソールのトークンリストでそのキーが無効化・削除されていないか;③ アカウントのクレジットを使い切っていないか;④ Authorization ヘッダーの形式が Bearer sk-... になっているか(Bearer の後に半角スペースが必要)。
429 リクエストが多すぎる?
ゲートウェイはトークンごとにレート制限を設けています。並列数を下げ、リトライのバックオフを長くし(指数バックオフ+ジッターを推奨)、またはコンソールでトークンのレート上限を引き上げてください。
ストリーミング出力が途中で切れる?
長文の返信では SDK のタイムアウトリトライを有効にすることを推奨します。企業プロキシを経由している場合は、プロキシが SSE ストリーム(text/event-stream)をバッファリングしていないか確認してください。
どのモデルに対応していますか?
コンソールの「モデル」ページにあるリアルタイムのリストが基準です。4-4 AI は GLM、DeepSeek、Qwen などの主要モデルを集約し、同じキー・同じインターフェースで切替できます。