Source: https://ailoot.ai/docs/ja/api/responses/
Canonical: https://ailoot.ai/docs/ja/api/responses/
Language: ja

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

# Responses

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

OpenAIの新しい形式。一つの入力、型付き出力、ツール、推論に対応します。Codex CLIが使用する形式です。

POST`https://api.ailoot.ai/v1/responses`

Responses

```bash
curl https://api.ailoot.ai/v1/responses \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "instructions": "簡潔に回答してください。",
    "input": "TCPとUDPはどう違いますか？"
  }' 
```

```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.responses.create(
    model="gpt-6.1-sol",
    instructions="簡潔に回答してください。",
    input="TCPとUDPはどう違いますか？",
)
print(resp.output_text)
```

```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.responses.create({
  model: "gpt-6.1-sol",
  instructions: "簡潔に回答してください。",
  input: "TCPとUDPはどう違いますか？",
});
console.log(resp.output_text);
```

200 OK

```json
{
  "id": "resp_67f1…",
  "object": "response",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "TCPはデータの到達と順序を保証します。UDPは保証しませんが、その分高速です…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}
```

## 認証

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

## リクエストボディ

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `model` | string | 必須 | Responses形式のモデルID。カタログには53あり、GPT、Claude、DeepSeek、Qwen、Kimi、GLM、MiniMax、Grokが含まれます。Geminiモデルはこの形式では利用できません。 |
| `input` | string \| array | 必須 | リクエストのテキスト、またはメッセージとパーツ（テキスト、画像）の配列。 |
| `instructions` | string | 任意 | システム指示。 |
| `stream` | boolean | 任意 | SSEイベントストリーム。最後のイベントは `response.completed`です。課金対象のテキストは、料金計算後に一つのブロックとして届きます。 |
| `max_output_tokens` | integer | 任意 | 次のフィールドを含むリクエスト：`previous_response_id` 、または組み込みツール `web_search` または `code_interpreter` を使う新しいテキストリクエストでは、保存されたコンテキストとツール処理をそれぞれ見積もります。入力ウィンドウ全体の料金が自動的に適用されるわけではありません。以前に受け入れた仮確保は、元の条件を維持します。出力が画像、動画、音声の場合は、結果の料金全額を仮確保します。 計算した仮確保額が利用可能な残高やキーの上限に収まらない場合、対応するモデルとメソッドに対して、Ailootは `max_tokens` (`max_output_tokens` はResponsesの場合)を、支払い可能な範囲まで引き下げることがあります。ただし、256トークン、またはそのメソッドで定められたより大きな最低量を下回りません。変更は次のヘッダーで通知します：`X-Ailoot-Max-Tokens-Capped`。この引き下げに対応するかどうかは、使用するテキストモデルとメソッドの組み合わせごとに確認します。ネイティブのGemini形式とAnthropic Messages形式の、対応するGeminiテキストルートで利用できます； `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` では、モデルが対応するChat Completions形式とMessages形式で行われます。 **出力** は、新しいテキストリクエストの仮確保において、標準的なレスポンス長と合意済みの条件に基づいて見積もります。要求する上限は `max_tokens` (`max_output_tokens` はResponsesの場合)。要求した上限が、そのまま仮確保の計算に使うトークン数になるわけではありません。また、出力長を確実に制限できないモデルでは、実際の出力長を保証しません。初期値4096が適用されるのは対応するルートだけで、具体的な規則はモデルとメソッドによって異なります。 |
| `reasoning` | object | 任意 | `{"effort": "low" \| "medium" \| "high"}` は推論モデル向けの指定です。 |
| `tools` | array | 任意 | モデルが呼び出せる関数。 |
| `text` | object | 任意 | レスポンス形式。例：`{"format": {"type": "json_schema", ...}}`。 |
| `temperature` | number | 任意 | モデルが対応している場合の、レスポンスのランダム性。 |

## レスポンス

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `output` | array |  | レスポンスの要素：メッセージ（`message`）、推論、関数呼び出し。SDKでは、次のフィールドを使うと便利です：`output_text`。 |
| `status` | string |  | `completed`, `incomplete` （制限に達した場合）、または `failed`。 |
| `usage` | object |  | `input_tokens`, `output_tokens`, `total_tokens`。 |

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

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





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





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





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