開発者向けクイックスタート

OpenAI 互換インターフェースを使って、最初の最小実用呼び出しを行います

MoleAPI に自分でコードを書いて接続する場合は、まず次の 2 点を覚えておいてください。

Base URL：https://api.moleapi.com/v1
認証方式：Authorization: Bearer <YOUR_API_KEY>

最も一般的な最初のインターフェースは次のとおりです。

POST /chat/completions

ステップ 0：まず 2 つのパラメータを環境に設定する

API Key をコードに直接ハードコードするのではなく、まず環境変数に設定することを推奨します。

PowerShell

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

Bash / zsh

export MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

なぜ最初に環境変数を使うのか

こうしておくと、ローカルテスト、CI、本番環境を切り替える際に、環境設定を差し替えるだけで済み、ソースコードを何度も修正する必要がありません。

cURL の例

Bash / zsh

curl https://api.moleapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MOLEAPI_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍 MoleAPI。"}
    ]
  }'

PowerShell

$headers = @{
  "Content-Type" = "application/json"
  "Authorization" = "Bearer $env:MOLEAPI_KEY"
}

$body = @{
  model = "gpt-4o-mini"
  messages = @(
    @{
      role = "user"
      content = "你好，请用一句话介绍 MoleAPI。"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "https://api.moleapi.com/v1/chat/completions" `
  -Headers $headers `
  -Body $body

リクエストが成功すると、通常は JSON レスポンスが返され、少なくとも次の内容が含まれます。

id
model
choices[0].message.content

モデルが正常にテキストを返していることを確認できれば、最小接続フローは正常に動作していると判断できます。

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": "你好，请返回一句接入成功提示。"}],
)

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

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 resp = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "你好，请返回一句接入成功提示。" }],
  });

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

main().catch(console.error);

初回の疎通確認では、この 3 点だけを確認することを推奨します

リクエストで正常な JSON レスポンスを受け取れる
返却内容がエラー情報ではない
使用しているモデル名と Group が現在利用可能である

この段階が安定してから、次の項目を段階的に追加してください。

ストリーミング出力
より長いコンテキスト
ツール呼び出し
画像、音声などのマルチモーダル機能

最小限のトラブルシューティング手順

まず Base URL とパスが正しいことを確認する
次に API Key が有効であり、対象モデルへのアクセス権があることを確認する
最後にモデル名と現在の Group を照合する

小さく始めてから広げるのがおすすめ

まずは最短のリクエストで疎通確認を行い、その後で長いコンテキスト、ストリーミング出力、より複雑なパラメータを段階的に追加してください。

cURL では通るのに、プロジェクトのコードでは通らない場合

これは通常、プラットフォーム自体には問題がなく、プロジェクトの接続レイヤーに原因があることを示しています。優先的に次の点を確認してください。

コード内で本当に MOLEAPI_KEY を読み取れているか
SDK 設定の baseURL / base_url が他のプラットフォームを指したままになっていないか
アプリケーションコードでリクエスト URL を二重に連結していないか
プロキシ、Gateway、またはサーバー側の環境変数がローカルと一致しているか

次に何を見るべきか

従来の OpenAI chat/completions インターフェースに加えて、MoleAPI の一部モデルは OpenAI 最新の responses インターフェース、Gemini インターフェース、および Anthropic のリクエストインターフェースもサポートしています。対応状況と呼び出し方法の詳細については、API リファレンスを参照してください。

開発者向けクイックスタート

このページの目次