Source: https://ailoot.ai/docs/zh-hant-tw/api/responses/
Canonical: https://ailoot.ai/docs/zh-hant-tw/api/responses/
Language: zh-hant-tw

[API](https://ailoot.ai/docs/zh-hant-tw/) 

# Responses

[Markdown](https://ailoot.ai/docs/zh-hant-tw/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 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 只適用於相應路由；具體規則依模型與方法而異。 |
| `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將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。