# クイックスタート

> curl または OpenAI SDK を使って、最初の LLMoxy API リクエストを送信します。

LLMoxy は OpenAI 互換の大規模モデル集約ゲートウェイです。LLMoxy の API Key が 1 つあれば、ベンダーごとにアカウントを申請・管理することなく、OpenAI、Claude、Gemini などのモデルを切り替えて利用できます。

## API Key を作成する

1. [llmoxy.com](https://llmoxy.com) でアカウントを登録し、ログインします。
2. **コンソール → トークン** を開き、新規作成をクリックします。
3. 生成された Key をコピーします。通常は `sk-` で始まります。大切に保管し、漏えいした場合はすぐに同じページで無効化して作り直してください。

## Base URL

OpenAI 互換のクライアントはすべて、同じアドレスを使用します。

```txt
https://llmoxy.com/v1
```

その他のリクエスト形式（Anthropic、Gemini）は、同一オリジンのサブパスを使用します。詳しくは **互換フォーマット** を参照してください。

## 最初のリクエスト

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "messages": [
      { "role": "user", "content": "Say hello in one short sentence." }
    ]
  }'
```

`<LLMOXY_API_KEY>` を、先ほど作成した Key に置き換えてください。モデル名は `GET /v1/models` で確認できるほか、コンソールのモデルリストでも閲覧できます。

## OpenAI SDK

```ts
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LLMOXY_API_KEY,
  baseURL: "https://llmoxy.com/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4.7",
  messages: [{ role: "user", content: "Write a haiku about routers." }],
});

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

```py
from openai import OpenAI

client = OpenAI(
    api_key="<LLMOXY_API_KEY>",
    base_url="https://llmoxy.com/v1",
)

response = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "Write a haiku about routers."}],
)

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

## ストリーミング出力

Chat Completions リクエストで `stream: true` を設定すると、LLMoxy は OpenAI 互換の SSE ストリームを返します。

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Count from one to five." }
    ]
  }'
```

## 次のステップ

- `GET /v1/models` を使って、現在の Key で利用できるすべてのモデルを確認します。
- **認証** を読んで、各ベンダー形式のリクエストヘッダーへの対応状況を把握します。
- **Chat Completions** を読んで、その形式で接続します。

これは https://jp.llmoxy.com/docs/get-started/quickstart の markdown 版です。
