公式 SDK サポート

MoleAPI は主要な OpenAI スタイルの SDK と互換性があります。通常、置き換える必要があるのは次の 2 点だけです。

apiKey
baseURL

どのような場合に SDK を直接使うべきか

以下のいずれかに当てはまる場合は、通常、自分で HTTP リクエストを組み立てるよりも、公式 SDK を優先して使用するべきです。

すでに Python / Node.js で業務開発を行っている
今後、ストリーミング出力、画像、音声、またはツール呼び出しも扱う予定がある
低レベルなリクエストの詳細処理を減らし、まず機能を動かしたい

簡単な判断基準

アカウントが利用可能かどうかを確認したいだけなら、まずは cURL を使います。機能をプロジェクトに組み込むのであれば、SDK を優先して使ってください。

Python の例

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["MOLEAPI_KEY"],
    base_url="https://api.moleapi.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "用一句话说明 SDK 接入要点"}],
)

print(resp.choices[0].message.content)

まだ環境変数を設定していない場合は、まず現在のターミナルで次を実行できます。

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

Node.js の例

import OpenAI from "openai";

async function main() {
  const client = new OpenAI({
    apiKey: process.env.MOLEAPI_KEY,
    baseURL: "https://api.moleapi.com/v1",
  });

  const res = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "Hello MoleAPI" }],
  });

  console.log(res.choices[0]?.message?.content);
}

main().catch(console.error);

Node.js でも同様に、実際の Key をソースコードへ直接書き込んだりリポジトリへコミットしたりするのではなく、環境変数から読み取ることを推奨します。

最も一般的な互換性の問題

baseURL を別のプラットフォームのアドレスにしている、または /v1 が抜けている
環境変数の注入に失敗しており、リクエスト時に実際には空の値を取得している
サンプルをコピーする際に、互換性のないモデル名やパラメータまでそのまま含めてしまっている
ローカルでは動作するが、デプロイ先環境に同じ Key と Base URL が反映されていない

推奨される接続手順

まず最短のサンプルを 1 回動かす
次に、実際の業務で使うモデルに置き換える
最後に、ストリーミング出力、Retry、タイムアウト、ログを追加する

この手順が最も問題の切り分けをしやすく、「プラットフォームへの接続自体が通っていない」のか、それとも「業務側の複雑なロジックによって新たな問題が入った」のかを明確に把握できます。

よくあるトラブルシューティング

401 が返る: まず API Key と環境変数を確認する
404 が返る: まず baseURL に /v1 が含まれているか確認する
モデルが利用できないと表示される: Group とモデル権限を確認する