curl クイックスタート

最小の OpenAI compatible リクエストで経路全体を確認します。

準備

キーページで YOUR_API_KEY を準備します。
モデルと料金ページで利用可能なモデルを選び、YOUR_MODEL を置き換えます。
https://api.popgo.site に到達できるネットワークか確認します。

接続前チェックリスト

最初は YOUR_API_KEY と YOUR_MODEL だけ置き換えます。パス、プロトコル、高度なクライアント設定を同時に変えないでください。
アプリが Base URL を求める場合は、各ガイドのルートまたは /v1 レベルを入力します。完全な Endpoint は、アプリが明示的に求める場合だけ使います。
Quickstart で一度成功してから、同じ Key、モデル、アドレスをクライアントへコピーします。

プロトコル別にアドレスと endpoint を選ぶ

OpenAI compatible クライアントは通常 /v1 Base URL を使います。Claude Messages と Gemini ネイティブはルートアドレスを使い、クライアントまたは完全な Endpoint がプロトコルパスを追加します。

完全な公開 endpoint 一覧は API Reference を参照してください。動画タスクとメディアパラメータは画像と動画生成を参照してください。

ローカル環境の準備

CLI、スクリプト、または Node.js が必要なツールを使う場合は、先に Node.js と npm をインストールします。ツールを起動する同じターミナルでバージョンを確認してください。

node --version
npm --version

Windows：公式インストーラーまたはシステムのパッケージマネージャーで Node.js LTS を入れます。
macOS：公式インストーラーまたは Homebrew を使います。
Linux/WSL2：ディストリビューションのパッケージマネージャーまたは Node.js 推奨手順を使います。
インストール後もコマンドが見つからない場合は、古いターミナルを閉じて新しく開き、更新された PATH を読み込ませます。

リクエストを送信

この例は OpenAI compatible Base URL を使用します。

curl https://api.popgo.site/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "接続を確認してください"}
    ]
  }'

成功の確認

成功 HTTP ステータスとアシスタント内容が返れば、Base URL、キー、モデルは有効です。失敗した場合は対応するステータスの対処を確認します。

次の手順

クライアントが対応する OpenAI、Claude、Gemini ガイド、またはソフトウェア連携に進みます。

準備​

接続前チェックリスト​

プロトコル別にアドレスと endpoint を選ぶ​

ローカル環境の準備​

リクエストを送信​

成功の確認​

次の手順​

準備