4-4 AI クイックスタート:5分で統一AI APIに接続

チュートリアル · 2026-11-20 · 約8分で読める

このチュートリアルでは、4-4 AI への接続をゼロから最後まで案内します:キー取得 → Base URL 設定 → 最初のストリーミング出力を動かすまで。全体を通して OpenAI 互換インターフェースを使います——カスタム Base URL に対応した既存のコード・フレームワーク・ツール(openai SDK、LangChain、Cursor など)はコードロジックを変える必要がなく、設定を変えるだけです。

事前準備

  1. www.4-4.vip にアクセスし、アカウント登録のうえコンソールにログインします。
  2. コンソールでチャージするか、カードコードでクレジットを引き換えます。
  3. 「トークン」ページで新しい API キー(sk-... 形式)を作成し、大切に保管してください——作成時に一度だけ完全な形で表示されます。
セキュリティに関する注意:API キーはアカウント残高と同等です。Git リポジトリやフロントエンドコードにコミットしないでください。環境変数での管理を推奨します。

中核概念:Base URL とキー

4-4 AI は OpenAI と完全互換のインターフェースプロトコルを提供します。覚えるべき設定は 2 つだけです:

設定項目値
Base URLhttps://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);

主要フレームワーク・ツールの接続

よくある質問(FAQ)

401 Invalid API Key エラーが出る?

順番に確認してください:① キーをコピーしたとき空白や改行が混入していないか;② コンソールのトークンリストでそのキーが無効化・削除されていないか;③ アカウントのクレジットを使い切っていないか;④ Authorization ヘッダーの形式が Bearer sk-... になっているか(Bearer の後に半角スペースが必要)。

429 リクエストが多すぎる?

ゲートウェイはトークンごとにレート制限を設けています。並列数を下げ、リトライのバックオフを長くし(指数バックオフ+ジッターを推奨)、またはコンソールでトークンのレート上限を引き上げてください。

ストリーミング出力が途中で切れる?

長文の返信では SDK のタイムアウトリトライを有効にすることを推奨します。企業プロキシを経由している場合は、プロキシが SSE ストリーム(text/event-stream)をバッファリングしていないか確認してください。

どのモデルに対応していますか?

コンソールの「モデル」ページにあるリアルタイムのリストが基準です。4-4 AI は GLM、DeepSeek、Qwen などの主要モデルを集約し、同じキー・同じインターフェースで切替できます。

関連記事

自前構築 one-api / new-api vs マネージドAIゲートウェイ:コスト・運用・セキュリティ比較 「ゲートウェイを自前で構築すべきか」で迷うチーム向けの正直な意思決定フレームワーク:隠れた運用コスト、障害シナリオの比較、どの段階でどちらを選ぶか。 Cursor / Claude Code / Cherry Studio をカスタムAIゲートウェイに接続するガイド 主要AIコーディング・チャットツールのカスタムBase URL設定手順、401/404/モデル不可用のトラブルシュート早見表付き。
接続する準備はできましたか?

1つのキーで GLM、DeepSeek、Qwen などの主要モデルに統一接続。課金の統一と使用量の可視化に対応。

モデルと料金を見る 登録して試す