Responses

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はどう違いますか？"
  }' 

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)

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

{
  "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 }
}

認証

• Authorizationheader必須

  キーの形式：Bearer sk-…。次のヘッダーも使用できます：x-api-key または x-goog-api-key。

リクエストボディ

• modelstring必須

  Responses形式のモデルID。カタログには53あり、GPT、Claude、DeepSeek、Qwen、Kimi、GLM、MiniMax、Grokが含まれます。Geminiモデルはこの形式では利用できません。

• inputstring | array必須

  リクエストのテキスト、またはメッセージとパーツ（テキスト、画像）の配列。

• instructionsstring任意

  システム指示。

• streamboolean任意

  SSEイベントストリーム。最後のイベントは response.completedです。課金対象のテキストは、料金計算後に一つのブロックとして届きます。

• max_output_tokensinteger任意

  次のフィールドを含むリクエスト：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が適用されるのは対応するルートだけで、具体的な規則はモデルとメソッドによって異なります。

• reasoningobject任意

  {"effort": "low" | "medium" | "high"} は推論モデル向けの指定です。

• toolsarray任意

  モデルが呼び出せる関数。

• textobject任意

  レスポンス形式。例：{"format": {"type": "json_schema", ...}}。

• temperaturenumber任意

  モデルが対応している場合の、レスポンスのランダム性。

レスポンス

• outputarray

  レスポンスの要素：メッセージ（message）、推論、関数呼び出し。SDKでは、次のフィールドを使うと便利です：output_text。

• statusstring

  completed, incomplete （制限に達した場合）、または failed。

• usageobject

  input_tokens, output_tokens, total_tokens。