# API 概要

> LLMoxy API の Base URL、認証方式、および Python、Node.js、curl のクイックスタート例。

LLMoxy は完全互換の Anthropic Messages API インターフェースを提供します。Base URL を変更するだけで、公式 SDK をそのまま利用できます。

## Base URL

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

> **ヒント**
> Claude Code などのツールは `/v1` **なし** のアドレス、つまり `https://llmoxy.com` を使用します。SDK 呼び出し時は `/v1` を付けます。

## 認証方式

### 方式 1：x-api-key（推奨）

```http
x-api-key: YOUR_API_KEY
```

### 方式 2：Authorization

```http
Authorization: Bearer YOUR_API_KEY
```

## クイックスタート

### Python

```python
from anthropic import Anthropic

client = Anthropic(
api_key="YOUR_API_KEY",
base_url="https://llmoxy.com/v1"
)

message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[
{"role": "user", "content": "こんにちは！"}
]
)

print(message.content[0].text)
```

### Node.js

```js
import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://llmoxy.com/v1'
});

const message = await client.messages.create({
model: 'claude-opus-5-5',
max_tokens: 1024,
messages: [
{ role: 'user', content: 'こんにちは！' }
]
});

console.log(message.content[0].text);
```

### OpenAI 互換（Chat Completions）

#### curl

```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." }
    ]
  }'
```

#### TypeScript

```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);
```

#### Python

```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 または Responses リクエストで `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." }
    ]
  }'
```

## 対応モデル

### Claude シリーズ（利用可能なグループ：Claude）

| モデル | 説明 |
| --- | --- |
| claude-fable-5-2 | 最高性能 |
| claude-opus-5-5 | バランスの取れた選択 |

### Gemini シリーズ（利用可能なグループ：Gemini）

| モデル | 説明 |
| --- | --- |
| gemini-4-argon | 最高性能 |
| gemini-3.8-flash | 高速応答 |

> **最新モデル一覧**
> 利用可能なモデルの詳細は [公式モデル広場](https://llmoxy.com/) を参照してください。

## 課金方式

実際のトークン使用量（キャッシュ書き込みおよびキャッシュ読み取りを含む）に応じて課金されます。モデルごとに価格が異なります。詳細は [グループと価格](https://jp.llmoxy.com/docs/get-started/recharge-and-pricing) を参照してください。

## 次のステップ

- [Anthropic 形式の詳細ドキュメント](https://jp.llmoxy.com/docs/api-reference/anthropic-format) — リクエストパラメータ、レスポンス形式、コード例
- [Chat Completions](https://jp.llmoxy.com/docs/api-reference/chat-completions) — OpenAI 互換リクエスト形式
- [ルーティング、課金とエラー](https://jp.llmoxy.com/docs/api-reference/routing-billing-errors) — 料金とエラーコードについて

これは https://jp.llmoxy.com/docs/api-reference/api-overview の markdown 版です。
