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 token，或該方法規定的更高最低值，並透過此標頭通知：X-Ailoot-Max-Tokens-Capped。是否能降低上限，須針對特定文字模型與方法確認。此功能適用於 Gemini 在原生 Gemini 格式及 Anthropic Messages 格式中支援的文字路由； 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)。要求的上限不會自動等於計算保留金額所使用的 token 數；若模型無法可靠限制回應長度，要求的上限也不保證實際回應長度。初始值 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。