> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM クイックスタート

Sunra は3つの LLM API エンドポイントを提供しており、それぞれ異なるフォーマットに準拠しています。3つのエンドポイントはすべて同じ認証方式とベース URL（`https://api-llm.sunra.ai`）を使用するため、お使いの技術スタックに最適なフォーマットを選択できます。

始める前に、[ダッシュボード](https://sunra.ai/dashboard/api-tokens)から API キーを取得してください。

## Chat Completions — `/v1/chat/completions`

[Chat Completions](/ja/llm/chat) エンドポイントは **OpenAI Chat Completions** フォーマットに準拠しています。ロール（`system`、`user`、`assistant`）を持つメッセージのリストを受け取り、補完結果を返します。

OpenAI SDK やツールとのドロップイン互換性が必要な場合は、このエンドポイントを使用してください。

**主な機能：** ストリーミング、関数呼び出し、ビジョン（画像、音声、動画、ファイル）、推論、構造化出力（JSON schema / grammar）、logprobs。

```bash theme={null}
curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "What is the capital of France?" }
    ]
  }'
```

## Anthropic Messages — `/v1/messages`

[Anthropic Messages](/ja/llm/messages) エンドポイントは **Anthropic Messages API** フォーマットに準拠しています。`user` / `assistant` のメッセージロールを使用し、リッチなコンテンツブロックと独立した `system` パラメータをサポートしています。

Anthropic Claude モデルへのネイティブアクセスや、拡張思考、プロンプトキャッシング、引用、組み込みツール（ウェブ検索、コード実行）などの機能が必要な場合は、このエンドポイントを使用してください。

**主な機能：** ストリーミング、拡張思考、プロンプトキャッシング、ツール使用（カスタム + 組み込み）、PDF/ドキュメント入力、引用、構造化出力。

```bash theme={null}
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, how are you?" }
    ]
  }'
```

## Responses — `/v1/responses`

[Responses](/ja/llm/responses) エンドポイントは **OpenAI Responses API** フォーマットに準拠しています。柔軟な入力項目（メッセージ、関数呼び出し、推論）を受け取り、構造化された出力項目を返します。

組み込みウェブ検索、ファイル検索、コードインタープリター、コンピュータ使用、MCP ツール統合、画像生成など、最新の OpenAI Responses 機能が必要な場合は、このエンドポイントを使用してください。

**主な機能：** ストリーミング、関数呼び出し、ウェブ検索、ファイル検索、コードインタープリター、コンピュータ使用、MCP ツール、画像生成、推論、構造化出力。

```bash theme={null}
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'
```

## 適切なエンドポイントの選択

|             | Chat Completions    | Anthropic Messages | Responses                             |
| ----------- | ------------------- | ------------------ | ------------------------------------- |
| **フォーマット**  | OpenAI Chat         | Anthropic Messages | OpenAI Responses                      |
| **最適な用途**   | OpenAI SDK 互換性      | Claude ネイティブ機能     | 最新の OpenAI 機能                         |
| **ストリーミング** | SSE                 | SSE                | SSE                                   |
| **関数呼び出し**  | はい                  | はい（カスタム + 組み込み）    | はい                                    |
| **推論**      | はい                  | 拡張思考               | はい                                    |
| **構造化出力**   | JSON schema、grammar | JSON schema        | JSON schema                           |
| **組み込みツール** | —                   | ウェブ検索、コード実行        | ウェブ検索、ファイル検索、コードインタープリター、コンピュータ使用、MCP |

3つのエンドポイントはすべて同じ認証方式を共有しています。`Authorization` ヘッダーに Bearer トークンとして API キーを渡すだけで利用できます。