Source: https://ailoot.ai/docs/ja/api/chat-completions/
Canonical: https://ailoot.ai/docs/ja/api/chat-completions/
Language: ja

[API](https://ailoot.ai/docs/ja/) 

# Chat Completions

[Markdown](https://ailoot.ai/docs/ja/api/chat-completions/index.md)

OpenAI形式の、会話に対するモデルのレスポンス。最も広く使われている形式で、ほぼすべてのクライアントが対応しています。

POST`https://api.ailoot.ai/v1/chat/completions`

Chat Completions

```bash
curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "APIとは何か、二文で説明してください。"}
    ]
  }' 
```

```python
from openai import OpenAI
import os

client = OpenAI(max_retries=0, 
    base_url="https://api.ailoot.ai/v1",
    api_key=os.environ["AILOOT_API_KEY"],
)

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "APIとは何か、二文で説明してください。"}],
)
print(resp.choices[0].message.content)
```

```js
import OpenAI from "openai";

const client = new OpenAI({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai/v1",
  apiKey: process.env.AILOOT_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [{ role: "user", content: "APIとは何か、二文で説明してください。" }],
});
console.log(resp.choices[0].message.content);
```

200 OK

```json
{
  "id": "chatcmpl-8f2c…",
  "object": "chat.completion",
  "created": 1790812800,
  "model": "claude-sonnet-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "APIとは、あるプログラムが別のプログラムに処理を依頼する方法についての取り決めです…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}
```

## 認証

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `Authorization` | header | 必須 | キーの形式：`Bearer sk-…`。次のヘッダーも使用できます：`x-api-key` または `x-goog-api-key`。 |

## リクエストボディ

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `model` | string | 必須 | モデルIDの参照元：[カタログ](https://ailoot.ai/models/ja/)。例：`claude-sonnet-5-5`。モデルがOpenAI Chat形式に対応している必要があります。 |
| `messages` | array | 必須 | 会話履歴：オブジェクトには `role` (`system`, `developer`, `user`, `assistant`, `tool`)、 `content` があり、値は文字列またはパーツの配列（テキスト、 `image_url`). |
| `stream` | boolean | 任意 | Server-Sent Events形式のレスポンス。デフォルトは `false`。課金対象のテキストは、単語ごとではなく、料金計算後に一つのブロックとして届きます。 |
| `stream_options` | object | 任意 | `{"include_usage": true}` を指定すると、最終 `usage` がストリームの最後のイベントとして送信されます。 |
| `max_tokens` | integer | 任意 | レスポンスの最大トークン数。新しいフィールド名は `max_completion_tokens`です。制限を指定しない場合、Ailootが4096を設定します（モデルの出力制限がそれより小さい場合は、その制限値。Grokには独自の制限があります）。長いレスポンスでは制限を明示してください。指定しなければ、4096トークンで停止し、 `finish_reason: "length"`となります。この制限値は仮確保額に含まれるため、大きいほど多くの空き残高が必要です。 |
| `temperature` | number | 任意 | レスポンスのランダム性。通常は0から2です。推論モデルでは無視されることがあります。 |
| `top_p` | number | 任意 | temperatureの代わりに使用するパラメータ。トークン選択に使う確率質量の割合です。 |
| `stop` | string \| array | 任意 | 生成を停止する文字列。 |
| `tools` | array | 任意 | モデルが呼び出せる関数の定義。OpenAIと同じ形式です：`{"type": "function", "function": {...}}`。 |
| `tool_choice` | string \| object | 任意 | `auto`, `none`, `required` または特定の関数。 |
| `response_format` | object | 任意 | `{"type": "json_object"}` または `{"type": "json_schema", ...}` による構造化レスポンス。モデルが対応している場合に使用できます。 |
| `reasoning_effort` | string | 任意 | 推論モデルの推論の深さ：`low`, `medium`, `high`。 |

その他のOpenAIパラメータは、そのまま渡されます。個々のモデルが対応するかどうかは、モデル開発元が決めます。

## レスポンス

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `choices[].message` | object |  | モデルのレスポンス：`content`、ツールを呼び出す場合は `tool_calls`。 |
| `choices[].finish_reason` | string |  | `stop` はレスポンスの完了を示します； `length` は次の上限に達したことを示します：`max_tokens` （この場合もレスポンスは完全なものとして扱われ、実際の使用量に基づいて課金されます）； `tool_calls` はモデルがツールを呼び出していることを示します。 |
| `usage` | object |  | `prompt_tokens`, `completion_tokens`, `total_tokens` に基づいて残高から差し引く金額が計算されます。 |

ご不明な点はありますか？Request IDと状況の説明をお送りください。調査をお手伝いします。[サポートに問い合わせる](mailto:support@ailoot.ai)

## Ailoot · 企業とそのプロジェクト群





Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。





企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。





Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。