API クイックスタート

このガイドでは、OpenAI 互換の Chat Completions エンドポイントに基本的なリクエストを送信します。

前提条件

  • GetRouter の API キー
  • Models に掲載されている互換性のあるモデル ID

サンプル用の環境変数を設定します。

export GETROUTER_API_KEY="YOUR_API_KEY"
export GETROUTER_MODEL="MODEL_ID"

cURL

curl https://getrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $GETROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$GETROUTER_MODEL"'",
    "messages": [
      {"role": "user", "content": "信頼性の高い API について 1 文で説明してください。"}
    ]
  }'

生成されたテキストは次の場所に返されます。

choices[0].message.content

Python

OpenAI SDK をインストールします。

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GETROUTER_API_KEY"],
    base_url="https://getrouter.ai/v1",
)

response = client.chat.completions.create(
    model=os.environ["GETROUTER_MODEL"],
    messages=[
        {"role": "user", "content": "信頼性の高い API について 1 文で説明してください。"}
    ],
)

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

Node.js / TypeScript

OpenAI SDK をインストールします。

bun add openai
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.GETROUTER_API_KEY,
  baseURL: 'https://getrouter.ai/v1',
})

const response = await client.chat.completions.create({
  model: process.env.GETROUTER_MODEL!,
  messages: [
    { role: 'user', content: '信頼性の高い API について 1 文で説明してください。' },
  ],
})

console.log(response.choices[0]?.message.content)

最初のリクエストでよくあるエラー

エラー確認事項
401API キーが完全で有効であり、Bearer YOUR_API_KEY として送信されているか
404Base URL が重複しておらず、クライアントが /chat/completions を呼び出しているか
Model not foundModels に掲載されている正しいモデル ID を使用しているか
Insufficient balance or quotaアカウント残高と API キーの利用上限を確認
Unsupported operationChat Completions に対応したモデルを選択

次のステップ