Responses 格式

OpenAI Responses API，用於建立模型回應。支援多輪對話、工具呼叫、推理等功能。

欄位	值
Base URL	`https://token.easyapi.com/v1`
認證	Authorization: Bearer `API_KEY`
示例模型	`gpt-4o`
格式	OpenAI Responses 相容
計費	按量計費

注意：完整路徑為 POST /v1/responses。input 可為字串或訊息陣列；可透過 previous_response_id 延續多輪對話。同樣支援 usage.include、models 與 provider.sort，見下方請求體說明。

示例模型

下文均以 gpt-4o（GPT-4o）為例；更換其他模型時，請替換 model 參數，並參考控制台模型說明調整 size、quality 等欄位。

建立回應

POSThttps://token.easyapi.com/v1/responses

使用 OpenAI Responses API 建立模型回應，支援多輪對話、工具呼叫與推理。

請求參數

名稱	位置	類型	必選	說明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer `API_KEY`
`Content-Type`	header	string	是	請求體格式

請求體

名稱	類型	必選	說明
`model`	string	是	模型 ID
`input`	string \| array<object>	否	輸入內容，可以是字串或訊息陣列
`instructions`	string	否	系統級指令，影響模型行為
`max_output_tokens`	integer	否	最大輸出 Token 數
`temperature`	number	否	取樣溫度
`top_p`	number	否	核取樣參數
`stream`	boolean	否	是否串流回應
`tools`	array<object>	否	可呼叫的工具定義列表
`tool_choice`	string \| object	否	工具選擇策略，字串或物件
`reasoning`	object	否	推理相關設定
`previous_response_id`	string	否	上一輪回應 ID，用於多輪對話
`truncation`	string	否	截斷策略：auto
`usage`	object	否	設為 usage.include = true 時，回應的 usage 物件會多一個 cost 欄位（本次呼叫費用，USD）；串流請求在最後一個帶 usage 的區塊裡回傳。最終扣費以 GET /v1/generation 為準
`models`	array<string>	否	回退模型序列（最多 5 個）。主模型沒有可用渠道，或上游失敗且尚未開始輸出時，依序換用下一個模型重試；僅限本 Key 允許的模型
`provider`	object	否	同優先級渠道內的路由偏好：provider.sort 取 price 選最便宜的渠道；latency 選實測首字延遲最低的（非串流按端到端耗時）；throughput 選實測輸出 tokens/s 最高的。latency 與 throughput 用該模型在各渠道的真實請求實測，沒有實測資料時退回渠道測速。模型名後綴 :floor 等價 sort=price，:nitro 等價 sort=throughput

示例

{
  "model": "gpt-4o",
  "input": "Hello!",
  "instructions": "You are a helpful assistant.",
  "max_output_tokens": 1024,
  "usage": {
    "include": true
  }
}

返回示例

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1718452800,
  "status": "completed",
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Hello! How can I help you today?"
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 12,
    "total_tokens": 27,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 15,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 12,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    },
    "cost": 0.0000875
  }
}